Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs-index.html
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ <h1>Documentation Files</h1>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/cache.md" target="_blank">cache.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/decoder.md" target="_blank">decoder.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/dmesg.md" target="_blank">dmesg.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/downloading_files.md" target="_blank">downloading_files.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/dump.md" target="_blank">dump.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/exportModifier.md" target="_blank">exportModifier.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/fileBytes.md" target="_blank">fileBytes.md</a></li>
Expand All @@ -29,7 +30,6 @@ <h1>Documentation Files</h1>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/helpers.md" target="_blank">helpers.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/hidden_members.md" target="_blank">hidden_members.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/history-of-bytes.md" target="_blank">history-of-bytes.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/how-to-download-files-in-makecode.md" target="_blank">how-to-download-files-in-makecode.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/implementingAnIndexSignature.md" target="_blank">implementingAnIndexSignature.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/internal_properties.md" target="_blank">internal_properties.md</a></li>
<li><a href="https://raw.githubusercontent.com/DeveloperTryingToCodeLikeOtherOfThem/pxt-hardware-programming-docs/master/docs/limit_of_offsets_for_setNumber.md" target="_blank">limit_of_offsets_for_setNumber.md</a></li>
Expand Down
8 changes: 8 additions & 0 deletions docs/downloading_files.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
## Downloading Files

To download files in MakeCode (all PXT target), it is simple, just click the download button in the bottom-center corner which is between the project's title bar and GitHub's logo. If the editor you have does **not** contain the GitHub logo, it will still be in the same position, but without the logo.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Grammar and clarity improvements. "all PXT target" should be plural, and the sentence structure can be improved for better readability.

Suggested change
To download files in MakeCode (all PXT target), it is simple, just click the download button in the bottom-center corner which is between the project's title bar and GitHub's logo. If the editor you have does **not** contain the GitHub logo, it will still be in the same position, but without the logo.
To download files in MakeCode (all PXT targets), simply click the download button in the bottom-center corner, located between the project's title bar and the GitHub logo. If the editor does **not** contain the GitHub logo, the button will still be in the same position.

All files are downloaded in the whole project itself, **not** by **indepent files**. The file's data type is a .mkcd (makecode) file.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Typo: "indepent" should be "independent". Also, "by indepent files" is slightly awkward; "as independent files" is clearer.

Suggested change
All files are downloaded in the whole project itself, **not** by **indepent files**. The file's data type is a .mkcd (makecode) file.
All files are downloaded as part of the project itself, **not** as **independent files**. The file extension is .mkcd (MakeCode).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Describe the correct download file type

This line states that downloading in "all PXT target" editors produces a .mkcd file, which is incorrect for common targets (for example, hardware targets typically download firmware artifacts such as .uf2/.hex). Because the page is framed as general guidance, users can end up looking for the wrong artifact type and fail to complete flashing/deployment steps after download.

Useful? React with 👍 / 👎.

When the file is done downloading, the compiler will show a picture frame of the game in that moment.
This is mainly because it helps to easier identify that current frame that is happening to the game to make other users
to understand what is cool in this project. This is more like an ad showing something intresting about what the game is about
in that current frame.
Comment on lines +5 to +8
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Grammar and spelling improvements. "picture frame" is better described as a "screenshot" or "thumbnail". "easier identify" should be "more easily identify", and "intresting" is a typo.

Suggested change
When the file is done downloading, the compiler will show a picture frame of the game in that moment.
This is mainly because it helps to easier identify that current frame that is happening to the game to make other users
to understand what is cool in this project. This is more like an ad showing something intresting about what the game is about
in that current frame.
When the download completes, the editor displays a screenshot of the game at that moment.
This helps users more easily identify the state of the game and understand its features.
It acts as a preview showing something interesting about the project.

Loading