Opened 3 years ago
Last modified 3 years ago
#17063 new enhancement
Development Documentation Refactoring — at Version 2
Reported by: | kallisti5 | Owned by: | nielx |
---|---|---|---|
Priority: | normal | Milestone: | Unscheduled |
Component: | Documentation | Version: | R1/Development |
Keywords: | api pootle developer | Cc: | |
Blocked By: | Blocking: | ||
Platform: | All |
Description (last modified by )
We really should reformat our developer documentation.
- User Guide
- https://www.haiku-os.org/docs/userguide/en/contents.html
- Generated from docs/userguide in git
- Each language packed into haiku_userguide_XX hpkgs
- "User Guide" Icon installed on desktop
- Developer Guide
- https://www.haiku-os.org/docs/api/
- Generated from docs/user in git
- URL "api"
- Called "Haiku Book" (aka like BeBook)
- Not packaged, only on www.haiku-os.org.
Ideally, I think we should make the following changes:
- Move code to docs/developerguide
- Package like userguide (haiku_developerguide*.hpkg)
- Add an icon to the desktop "Developer Guide"
- Move document to haiku-os.org/docs/developerguide (and make /docs/api a redirect)
I honestly didn't even know where the developer guide lived given the odd / inconsistent naming within our sources.
Change History (2)
comment:1 by , 3 years ago
Description: | modified (diff) |
---|
comment:2 by , 3 years ago
Description: | modified (diff) |
---|
Note:
See TracTickets
for help on using tickets.