Skip to content

Commit 08ae23e

Browse files
authored
Put 'Home page content' link in SUMMARY (#5408)
* put home page conten link in SUMMARY * use a standalone page until next pxt-core bump
1 parent aa45ce0 commit 08ae23e

File tree

2 files changed

+51
-4
lines changed

2 files changed

+51
-4
lines changed

docs/SUMMARY.md

+1
Original file line numberDiff line numberDiff line change
@@ -359,6 +359,7 @@
359359
* [Save](/save)
360360
* [Sign In](/identity/sign-in)
361361
* [Cloud Sync](/identity/cloud-sync)
362+
* [Home Page Content](/homepage-content)
362363

363364
* [Hardware](/device)
364365
* [Data Analysis](/device/data-analysis)

docs/homepage-content.md

+50-4
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,26 @@
1-
# @extends
1+
# Adding content to the home page
22

3-
## #target-homescreen
3+
The Editor home page contains galleries of card links to projects, tutorials, lessons, videos, and other content sources. Many content items featured on the home page are hosted at the editor's website while some other items are from external sources.
4+
5+
Much of content available on the home page is developed or selected by the MakeCode Team. Content from other contributors is welcomed though and can be featured in the home page galleries.
46

57
![Home page content example](/static/mb/homepage-content-example.jpg)
68

7-
## #target-link-example
9+
## Content requirements
10+
11+
* Your content should be open source and free to use without any restrictions other than author attribution (you may specify an open source license the provides for such usage if you wish).
12+
* The instructions should be well written and easy to follow.
13+
* It should not include any personally identifiable information beyond the author's name (authors can remain anonymous too).
14+
* Content will be reviewed and approved by the MakeCode Team.
15+
16+
## What you need to submit
17+
18+
To list a content item on the home page, you need to provide:
19+
20+
1. A name or title for the content item.
21+
2. A brief one or two sentence description of what your content is or does (preferably in English for localization and is 30 words or less).
22+
3. A thumbnail image that represents your content. Size the image to approximately **300 x 200** pixels.
23+
4. A full URL for the item. For a tutorial, a complete tutorial URL is needed (see https://makecode.com/writing-docs/user-tutorials for more details).
824

925
Here is the content link information mapped to a home page card example:
1026

@@ -15,6 +31,36 @@ Here is the content link information mapped to a home page card example:
1531
3. Thumbnail image (JPG or PNG)
1632
4. Content link URL (not shown on the home page card)
1733

34+
## Submission process
35+
36+
Create and submit a [GitHub issue](@githubUrl@/issues) requesting your content to be listed. In the issue description, include the name or title of the content item, description, content URL, and copy in the thumbnail image. GitHub will automatically create an image URL for your thumbnail when you paste or drag your image in. Your issue description will look something like this when you write it:
37+
38+
```
39+
Request to include a user content source on the editor home page. The content is a simple tutorial on how the create exploding sprites in Arcade.
40+
41+
## Home page link info
42+
43+
### Name
44+
45+
Exploding Sprites
46+
47+
### Description
48+
49+
Learn how to create moving sprites that randomly explode!
50+
51+
### Content Link
52+
53+
https://arcade.makecode.com/#tutorial:https://makecode.com/_rewr9iop
54+
55+
### Thumbnail
56+
57+
![image](https://github.com/microsoft/pxt/assets/27789908/f5c21294-1145-4010-8de0-560b8afbfeec)
58+
```
59+
1860
## Approval #target-approval
1961

20-
For approval to add items to the home page, please follow the **[instructions](https://support.microbit.org/support/solutions/articles/19000054952-makecode-extension-and-tutorial-approval)** for submitting content to the Micro:bit Foundation.
62+
For approval to add items to the home page, please follow the **[instructions](https://support.microbit.org/support/solutions/articles/19000054952-makecode-extension-and-tutorial-approval)** for submitting content to the Micro:bit Foundation.
63+
64+
## Featured content
65+
66+
To request featured space in the Home Page banner carousel, the requirements are similar to gallery items except for the image size. We require a link, a short description, and a "Hero" image that is **2100 x 500** pixels. Please note that banner space is very limited and approval for items included there is very selective.

0 commit comments

Comments
 (0)