more than a howto section, it is a wiki area that is needed here. Once a trick is given by someone it is not possible to add mentions, or to modify it if you are not the author.
+1 for the wiki area
Thanks guys for the suggestion, we can use Discourse Wikification feature which consists of
- Only Trust Level 2 (Regular user) user can open a new post into Howto section
- Only Admin can turn a post in a wiki
- Only Trust Level 1 (Basic User) can edit a wiki post
- Creator receives a notification when a wiki post is edited
See this example: Adagios installation on NethServer 6.x
What do you think?
@alefattorini it’s ok for me
Discourse is a great collaboration tool, too!
We could also
- publish a “stable enough” howto as a blog-post, or
- create an howto section into the official web site.
Why not? The big advantage of keeping howtos here is the global serch, you can search a term in bug/support/features/howto/discussion at the same time or filtering by category. Simple and effective.
You’re right! Let’s see how far it goes
Fast and easy, I like it!
I think a wiki is always a good start place.
A very good exemple is the Gentoo Linux documentation:
Because an “how to” is not all…
There are how to for developpers, there are how to for users, there are how to for documentation writers, etc, etc…
I said my opinion above:
But we could think to a wiki, I’d like to have a wiki markdown based (so we can copy/paste proposals and drafts crafted here) and github could be a good choice. Easy, no maintainance, great editor and people can fork and make pull requests.
@davidep and @giacomo would like to move bug tracker there in the future, moving wiki and howto should not be a problem.
We will lost global search but we can link here docs or and index
It seems ReadTheDocs supports Markdown too!
Wiki area, I prefer it.
I like howtos but our goal is to “spread the word” and to achieve it I think a wiki is a better tool.
We can start with something like this with a little effort
I mention GitHub just for a reason:
- it supports Markdown very well so we can copy/paste howtos born here on community or drafts extracted from posts
- no new machine to administer, update, maintain or pay
- it’s a powerful wiki, used by a lot of people
Does anyone has used it before?
Markdown is supported by ReadTheDocs too, where the Admin Manual is now published.
I like the Admin manual and its format, there is something to fix in the full-text search but it could works.
Just a doubt: might people get in confusion using the same platform/formatting style?
AFIK ReadTheDocs supports customizable themes and source code is hosted on GitHub.
This is only an idea. I think GitHub wiki is fine too.