Howto section or wiki area?

[AbsyntH (Michele Bortolotto)]

let’s go @alefattorini we need the HowTo section to add this “copy-n-paste-how-to” ! goodwork @nrauso , i had missed all the nethserver’s registration part on my installation…now i’ve fixed

[stephdl (Stéphane de Labrusse)]

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.

[AbsyntH (Michele Bortolotto)]

+1 for the wiki area

[alefattorini (Alessio Fattorini)]

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?

[AbsyntH (Michele Bortolotto)]

@alefattorini it’s ok for me

[davidep (Davide Principi)]

+1

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.

[alefattorini (Alessio Fattorini)]

@davidep

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.

[davidep (Davide Principi)]

@alefattorini

The big advantage of keeping howtos here is the global serch

You’re right! Let’s see how far it goes

[sitz (Roberto Sitzia)]

@alefattorini

See this example: http://community.nethserver.org/t/adagios-installation-on-nethserver/161What do you think?

Fast and easy, I like it!

[Jim]

Hello,

I think a wiki is always a good start place.
A very good exemple is the Gentoo Linux documentation:
https://wiki.gentoo.org/wiki/Main_Page

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…

[alefattorini (Alessio Fattorini)]

@alefattorini

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

I said my opinion above:

Howto section or wiki area?

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.

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

About wikis - GitHub Docs

[davidep (Davide Principi)]

It seems ReadTheDocs supports Markdown too!

Today I'm working on NethServer

Today I’m NOT working on NS… I’ve got a bad headache and I’m testing some pills I’ve a proposal for the howtos. I read on ReadTheDocs they support also Markdown, the same syntax of Discourse and Github! We could build an “official howtos” collection to complete the Administrator Guide! What does the Howto Team think? @AbsyntH, @sitz, @etino, @nrauso http://read-the-docs.readthedocs.org/en/latest/getting_started.html#in-markdown

[sitz (Roberto Sitzia)]

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.

[alefattorini (Alessio Fattorini)]

@Jim

I will still don’t desist to ask for a wiki

We can start with something like this with a little effort

Home

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?

[davidep (Davide Principi)]

Markdown is supported by ReadTheDocs too, where the Admin Manual is now published.

[sitz (Roberto Sitzia)]

@davidep

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?

[davidep (Davide Principi)]

AFIK ReadTheDocs supports customizable themes and source code is hosted on GitHub.

This is only an idea. I think GitHub wiki is fine too.