Have you ever discussed how to integrate the online docs and a wiki so
submissions, questions, comments and clarifications can more easily be
contributed, and available to the next learner? I understand the value of
the docs coming from source, but I only build from source on one of my home
macs, travel with a windows laptop, and have yet to learn the (admittedly
easy) help syntax. I would have contributed to the documentation already
had I been able to add something to the odd doc page with less friction.
One example might be adding links to other subjects that are related.
Another would be that we have in some places very dry upper level cs
descriptions of things, and I, not being formally trained, would add some
examples as I learned what they mean :)
AFAIK, the wiki uses a straight text file. How hard would it be to have two
help files for each code folder - one factor code, one the wiki maintained
text page. The official online wiki draws from and modifies a git
repository which periodically gets merged back into the build. The built
in browser combines the compiled and textual files, and may even allow for
quick editing locally for personal notes.
I'd think managing the second, wiki help file would be easier with git if it
were in its own folder system, parallel to the code base but maybe nestled a
folder lower, like \factor\wiki\basis, \factor\wiki\core.
I will be able to contribute work on this starting in November, if you think
it is potentially something that would work. Please let me know if there
are other, easier ways to accomplish the same thing. I have been eager to
contribute, but most of your work is at a higher theoretical level than I
function at.
Jim
On Wed, Sep 29, 2010 at 1:19 AM, Chris Double <chris.dou...@double.co.nz>wrote:
> On Wed, Sep 29, 2010 at 9:16 PM, John Sampson <jrs....@ntlworld.com>
> wrote:
> >
> > Factor looks to an outsider as if it could be quite interesting but
> > on trying to explore the Wiki on features there are only blank pages.
>
> Most of the good stuff is in the online docs:
>
> http://docs.factorcode.org
>
> Chris.
>
>
> ------------------------------------------------------------------------------
> Start uncovering the many advantages of virtual appliances
> and start using them to simplify application deployment and
> accelerate your shift to cloud computing.
> http://p.sf.net/sfu/novell-sfdev2dev
> _______________________________________________
> Factor-talk mailing list
> Factor-talk@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/factor-talk
>
--
Jim
"I'm for extending the working Medicare program for our seniors all the way
back to contraception, so Americans can concentrate on living their lives
without fear of changing a job, going bankrupt from deductibles or fighting
HMO bureaucracy."
------------------------------------------------------------------------------
Start uncovering the many advantages of virtual appliances
and start using them to simplify application deployment and
accelerate your shift to cloud computing.
http://p.sf.net/sfu/novell-sfdev2dev
_______________________________________________
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk
