On 22/11/11 22:16, George Vamos wrote:
1. I downloaded the svn tree you mentioned, and see a lot of
".mdtext" files. Is there a tutorial for this format? Is there a
tool to convert ".mdtext" to HTML? In general, do you guys have a
"standard" tooling setup?
We're using the Apache CMS:
http://www.apache.org/dev/cmsref.html
http://www.apache.org/dev/cms.html
2. Should I add documentation issues to Jira,
Yes please. By default, you can assign documentation Jira issues to me,
as I'm currently stewarding the web site. You don't need to log Jira
issues for TODO elements or broken links (yet) - when the site is
slightly more settled, I plan to run a link checker as a routine
operation, but right now there are too many "known unknowns" to quote Mr
Cheyney :)
or should I describe
the issue at the top of the email, and your committers would add an
issue with the patch if they consider it valid?
We can reject issues if we want to, so as long as you don't find that
disheartening that's what I suggest!
(As an aside, I
would be happy to write a "howto" for the basic process if it is
explained to me.)
Sorry, don't understand this.
3. You seem to be the main driver in the project, so I am flattered
with your reply. On the other hand, is there someone who could
mentor me a bit (you, or someone else, hopefully not take too much
time) so I can come up to speed, without cluttering up your main
mailing list. Additionally, I would like to discuss offline where
new pages (reading lists, howtos, mini-tutorials) would best be
added, so it stays consistent with whatever documentation
architecture you guys want to maintain.
It's ASF policy that all project discussions take place on-list, to
encourage participation and not have hidden discussions or decisions.
4. If you wish, I can just make patches and send them in (once I
figure out the workings of the ".mdtext") but I think I could do a
better job if I establish a 1-to-1 connection with someone in your
group. If you cannot designate a person, of course I can still send
patches, but I the results would not be as good.
I think you may be over-complicating the process. Find an area of the
documentation that you'd like to contribute to, pitch in, write some
content, log it in Jira and we'll refine it as we go.
Ian
--
____________________________________________________________
Ian Dickinson Epimorphics Ltd, Bristol, UK
mailto:[email protected] http://www.epimorphics.com
cell: +44-7786-850536 landline: +44-1275-399069
------------------------------------------------------------
Epimorphics Ltd. is a limited company registered in England
(no. 7016688). Registered address: Court Lodge, 105 High St,
Portishead, Bristol BS20 6PT, UK
