<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
</head>
<body bgcolor="#FFFFFF" text="#000000">
Hi guys,<br>
<br>
I'd like to share some thoughts about our documentation and
information tools.<br>
<br>
It's not hard to see, that "all that OpenCSW has" in regards to any
kind of information for users/maintainers/devs is spread across a
wide variety of tools & places.<br>
<br>
Dago & I discussed this at the camp, and as Maciej has
mentioned, parts of this have already been discussed earlier:<br>
<ul>
<li><a class="moz-txt-link-freetext" href="http://lists.opencsw.org/pipermail/maintainers/2009-March/007260.html">http://lists.opencsw.org/pipermail/maintainers/2009-March/007260.html</a></li>
<li><a class="moz-txt-link-freetext" href="http://lists.opencsw.org/pipermail/maintainers/2010-November/013224.html">http://lists.opencsw.org/pipermail/maintainers/2010-November/013224.html</a></li>
<li><a class="moz-txt-link-freetext" href="http://lists.opencsw.org/pipermail/maintainers/2013-April/017968.html">http://lists.opencsw.org/pipermail/maintainers/2013-April/017968.html</a></li>
<li><a class="moz-txt-link-freetext" href="http://lists.opencsw.org/pipermail/maintainers/2013-September/018607.html">http://lists.opencsw.org/pipermail/maintainers/2013-September/018607.html</a></li>
</ul>
<br>
First of all, here's a list of all the tools & places I could
find, that store information or act as a communication platform:<br>
(tell me if I forgot something)<br>
<ul>
<li><a class="moz-txt-link-abbreviated" href="http://www.opencsw.org">www.opencsw.org</a> (Wordpress)</li>
<li><a class="moz-txt-link-abbreviated" href="http://www.opencsw.org/manual">www.opencsw.org/manual</a> (Sphinx - Python Documentation
Generator)</li>
<li><a class="moz-txt-link-abbreviated" href="http://www.opencsw.org/community">www.opencsw.org/community</a> (OpenSource Q&A)</li>
<li>opencsw.wikidot.com (WikiDot)</li>
<li>pkgutil.wikidot.com (WikiDot)</li>
<li>github.com/opencsw (GitHub with gar, pkg-all, discourse, osqa)</li>
<li>opencsw.sourceforge.net (HTML?)</li>
<li>sourceforge.net/projects/opencsw (SourceForge Project)</li>
<li>sourceforge.net/projects/gar (SourceForge Project)</li>
<li>sourceforge.net/apps/trac/gar &
sourceforge.net/p/gar/tracwiki/Home (Trac, both sites seem to be
the same)</li>
</ul>
<br>
Also - just as an overview - we have/use the following:<br>
<ul>
<li>opencsw.org/mantis</li>
<li>buildfarm.opencsw.org</li>
<li>#opencsw on irc.freenode.net</li>
<li>Mail, Mailing Lists, Lists Archive, Webmail?</li>
<li>RSS Feeds</li>
<li>Flickr</li>
<li>YouTube</li>
<li>Google+</li>
<li>Twitter</li>
<li>Google Docs (group & shared files)</li>
<li>Facebook</li>
<li>Wikipedia</li>
<li>LinkedIn (nearly empty)</li>
</ul>
<br>
I'm not listing all of this because I think we should change it all.
Just to raise awareness.<br>
<br>
Now my thoughts:<br>
<ul>
<li>I think, that our website doesn't need to contain that much
information. It needs to get people started & provide access
to further information and tools (Daniel had some nice ideas
there).</li>
<li>The current info on the website, the manual, the wiki(s) and
all info out there should be in one place. Preferably a tool
which may be edited over a browser, if we want to give all
people the ability to edit as well.</li>
<li>I support the idea of separating information from bugtracking
from mailing lists from social media, etc. There should be only
one place for the same kind of thing, but a place for each kind
of thing.</li>
<li>The rework should be coupled with the new website that Daniel
is working on.</li>
<li>It may be worth a thought if we should separate our "product"
(the recipes & packages) from our own tools (gar, buildfarm,
...) or combine them. I'm talking about info & bugtracking
& (...) for each or for both in one place. Having only one
place would/could reduce the maintenance on the tools, but maybe
lead to confusion for the users.</li>
<li>We should decide what needs to be done first, and what may
come later.</li>
</ul>
I would like to propose, that we decide on a existing or new tool
for storing & presenting information and then gradually start
moving stuff away from the old locations. I would volunteer to do
the moving.<br>
<br>
What are your thoughts?<br>
<br>
Cheers,<br>
Stefan
</body>
</html>