Frontmatter
| id | 7417 |
| title | Polish the new 'Getting Started' Guide |
| state | Closed |
| labels | documentationhacktoberfest |
| assignees | Mariam-Saeed |
| createdAt | Oct 8, 2025, 3:19 PM |
| updatedAt | Oct 9, 2025, 1:06 PM |
| githubUrl | https://github.com/neomjs/neo/issues/7417 |
| author | tobiu |
| commentsCount | 2 |
| parentIssue | 7296 |
| subIssues | [] |
| subIssuesCompleted | 0 |
| subIssuesTotal | 0 |
| blockedBy | [] |
| blocking | [] |
| closedAt | Oct 9, 2025, 1:06 PM |
Polish the new 'Getting Started' Guide
tobiu assigned to @tobiu on Oct 8, 2025, 3:19 PM
tobiu added parent issue #7296 on Oct 8, 2025, 3:19 PM
tobiu cross-referenced by PR #7323 on Oct 8, 2025, 3:25 PM
tobiu unassigned from @tobiu on Oct 8, 2025, 5:28 PM
tobiu assigned to @Mariam-Saeed on Oct 8, 2025, 5:28 PM

tobiu
Oct 8, 2025, 5:29 PM
thx, appreciated! you could try gemini cli here.
- 2025-10-08T22:32:35Z @Mariam-Saeed cross-referenced by PR #7422
tobiu closed this issue on Oct 9, 2025, 1:06 PM
This ticket is a follow-up to the excellent new "Creating Your First App" guide. The goal is to make a few minor formatting adjustments to fully integrate it into the learning portal's rendering engine.
This is a great task to learn about the specifics of how the Neo.mjs documentation portal works.
Tasks:
Remove Manual Table of Contents: The file
learn/gettingstarted/CreatingYourFirstApp.mdcurrently has a manual Table of Contents at the top. The learning portal generates this automatically from the##headings, so this section should be removed.Correct Code Block Formatting: The portal requires a special flag on all fenced code blocks to render them correctly.
shellorplaintexttobash readonly.JavaScripttojavascript readonly.Add Guide to Navigation: To make the guide appear in the left-hand navigation of the learning portal, add an entry for it in the
learn/tree.jsonfile. It should be placed within the "Getting Started" section. The entry should look something like this:{"name": "Creating Your First App", "parentId": "GettingStarted", "id": "gettingstarted/CreatingYourFirstApp"}Verification:
After making the changes, you can see them live by:
npm run server-startin your terminal.http://localhost:8080/apps/portal/).