PfSense Community-Led Documentation Initiative
-
Bump?
Is this in the wrong section? I'd love to hear what you all think about this…
-
We (the pfsense team) would be quite happy to see people helping out with documentation. We encourage any work that is done in that section. :)
-
Good to know! I guess the next step is to start taking volunteers for this project.
I'll be the first, any more?
-
I'm proposing that we help out the devs by organizing the pfSense documentation and centralizing it in the pfSense wiki.
That's a fine idea, and i'd tinker here and there - but we need a Wiki. We need an actual site where we can edit a wiki.
Right now there is a FAQ that's hosted using phpMyFAQ, which nobody can edit. The forum is powered by SMF. And tutorials are hosted in PDFs.
There's no Wiki site using the Wiki engine that people can freely edit and contribute.
So until someone downloads MediaWiki, hosts it on a server, and points the pfSense homepage to it - a documentation project isn't going to get very far.
-
It's there and has been for a long time: http://doc.pfsense.org/index.php/Main_Page ;-)
-
It's there and has been for a long time: http://doc.pfsense.org/index.php/Main_Page ;-)
Yes, that is the wiki I was referring to in my original post. Isn't there an "old docs" that much of the old documentation used to be on, as well?
-
yes (http://olddoc.pfsense.org/index.php/Main_Page), but any work should go to the new one.
-
Definitely. The reason I asked was that we'll probably need to merge any remaining (if still correct) documentation from olddoc into the main docs wiki.
It might be good to still have available any information that only applies to older versions. Perhaps the first two places to go from the main page could be major version numbers. I'm not really sure what info is considered too dated to be included into the currecnt documentation, but I'm sure it exists (and I'm sure I'll learn what info applies to what version, intentionally or not).
I'm just brainstorming here. The easier systems to maintain are those that are logically organized, so I'm trying to figure out the best way to do this.
-
It's there and has been for a long time: http://doc.pfsense.org/index.php/Main_Page ;-)
Okay, step one is done. Step two is providing a link to this wiki on the homepage.
And why is wiki.pfsense.com not a wiki for pfSense, but a developer wiki for pfSense?
And the link on the homepage to documentation points to a wiki that is no longer there, redirecting to a dev wiki.You know what - just erase everything and start again.
-
Sorry all, haven't abandoned this, I just have the flu right now…
I should be jumping back on this in a few days, but in the meantime some suggestions and other input woulld be great!
-JP