Opened 16 years ago
Closed 11 years ago
#2725 closed enhancement (fixed)
Website, some essential docs are hard to find for newcomers
| Reported by: | aldeck | Owned by: | aldeck |
|---|---|---|---|
| Priority: | normal | Milestone: | R1 |
| Component: | Website | Version: | |
| Keywords: | Cc: | umccullough@… | |
| Blocked By: | Blocking: | ||
| Platform: | All |
Description
I'm seeing a lot of recurrent questions on IRC, forums and ml. I sometimes even have a hard time finding essential docs myself.
What we could do is rethink a bit the main page, i think we could add a "Testing" section that would contain useful links that don't really belong to the "Development" section (which is more a "Develop Haiku" section really).
"Testing" could contain links to:
- Prebuilt images (define what are the images exactly, had this question on IRC)
- Building from source + Build system FAQ (todo)
- Testing on a virtual machine -> usage for qemu, vmware, vbox etc..
- Testing on real hardware -> How To Boot Haiku (mmlr)
- Getting help
- Reporting bugs
Next would be to add a "Use Haiku" section, with links to basic use, particularities, tips, developing apps on haiku
Could be discussed on the ml though...
Change History (8)
comment:1 by , 16 years ago
comment:3 by , 16 years ago
| Cc: | added |
|---|
I'd also like to see this improved...
If someone will help me distill the content a bit, I'd like to refresh the guides into a single set of clear guides that are immediately easy to find.
My biggest problem is lack of focused time.
comment:5 by , 16 years ago
Good. I'm currently experimenting with a new infrastructure for docs. iFrodo, I suggest you drop a line on the haiku-web mailing list, I'm almost done with the preliminary work, so I will give you both some pointers there.
comment:7 by , 15 years ago
| Owner: | changed from to |
|---|---|
| Status: | new → assigned |
Working on it. see http://www.haiku-os.org/node/2923
comment:8 by , 11 years ago
| Resolution: | → fixed |
|---|---|
| Status: | in-progress → closed |
Documentation has been rearranged, improved and now covers most of the topics listed here, I feel it's safe to close this particular ticket.
I totally agree with the fact that documentation is not well organized. I do too have some hard time finding essential doc.
IMHO, the main page should have only a simple link: "Documentation" Then this page should be diveded in Developers - Users.
In the developer section you would put all the links, divided by topics, to all the articles. Same in the user sections, more or less like we do here http://www.haiku-os.it/documentazione
Anyway, this is just an idea. But definitely the current status needs to be changed.