Wiki-fying docs
Hiroki Sato
hrs at allbsd.org
Mon Nov 29 06:25:19 PST 2004
"Justin C. Sherrill" <justin at xxxxxxxxxxxxxxxxxx> wrote
in <1347.192.168.0.254.1101703802.squirrel at xxxxxxxxxxxxx>:
justin> I've noticed that there's been a number of people who have wanted to
justin> contribute to docs, but the process of installing the doc-proj port and
justin> all its dependencies, plus talking SGML, plus building it, is forming a
justin> sort of barrier to entry. I think I'm the only poor soul that's done it.
justin>
justin> I was thinking we could copy the existing docs into a Wiki, and see how
justin> contributions change from there. Mashing wiki changes back into CVS may
justin> be less laborious than putting other people through the docproj wringer.
justin> Can anyone think of any objections?
I am interested in translation and infrastructural work of dragonfly's
documentation and have several patches for them personally, but
I think switching the docs to a Wiki or the like is problematic
for languages other than English and output formats other than HTML.
So while it is not so easy to handle XML/SGML docs and its build
infrastructure as you pointed out, it is worth sticking to such
portable and standardized way.
BTW, is there anything I can do to help you? I can send the patches
if it would not be too much trouble...
--
| Hiroki SATO
Attachment:
pgp00002.pgp
-------------- next part --------------
A non-text attachment was scrubbed...
Name: pgp00002.pgp
Type: application/octet-stream
Size: 187 bytes
Desc: "Description: PGP signature"
URL: <http://lists.dragonflybsd.org/pipermail/docs/attachments/20041129/a847d32d/attachment-0019.obj>
More information about the Docs
mailing list