On 11/18/06, Stuart Rackham srackham-at-methods.co.nz |asciidoc| <...> wrote: > > Yang wrote: > > Hey Anmar, > > > > Stuart may have something more to say, but there isn't (and probably > > won't be in the near future) any resource for introducing developers > > to the code base (which to be fair is not that large, but I'd say is > > not exactly the best Python code I've seen - no offense to Stuart, who > > I'm sure whipped it up in a hurry and has much better things to work > > on). The question I asked and his reply: > > I'm not suggesting my code is the best on the planet, but hey it's out > there, it's free and it gets the job done. So rather than just sniping > with unsupported assertions why don't you share your expertise with us > and give some examples (or better still write some documentation > yourself). That way we all get to learn something.
Wow. Calm down, buddy. Again, no need to be offended. I was just trying to help answer a familiar question. Yes, I threw in a critique (barely), but there are better ways to win over contributors than to snap at your users. But to answer your question: I don't because at the moment I'm still assessing whether another project (Pandoc) would be a wiser investment of effort. Yang > > > > > >>> - Developers' documentation, to make it easier for others to > >>> understand (from a big-picture perspective) how the code is > >>> organized, such that we might be able to contribute more efficiently > >>> to the project. > >> AsciiDoc is a small fairly straight-forward program (just a 4000 line > >> Python script), and while I agree that a nice overview will, well, give > >> you nice overview and maybe a leg up the learning curve, if you want to > >> modify the source code there's no substitute for a working knowledge of > >> the application and just reading the source code. While I've found that > >> it's always a psychological hurdle to open up someone else source, you > >> very quickly get a much better understanding of how things are put > >> together. > > > > But perhaps for a specific question (e.g. table-related code) he can > > offer a pointer. > > > > Yang > > > > > > On 11/17/06, Anmar Oueja anmar-at-canada.com |asciidoc| > > <...> wrote: > >> Hello Stuart: > >> > >> I have been giving this a lot of thought. I went through many Wiki's > >> implementations of Tables (not code, just markup) and found a few good > >> ones. > >> > >> - Mediawiki has the most flexible and most suitable for multiple lines > >> within a table > >> - Dokuwiki has a simple but effective formatting > >> > >> I am willing to look into the code my self, although I am not a > >> developer. Do you know where can I get started? > >> > >> Cheers! > >> > >> Anmar > >> > >> Stuart Rackham wrote: > >>> Hi Anmar > >>> > >>> Anmar Oueja wrote: > >>>> Hello Stuart: > >>>> > >>>> Thanks for the quick response. Any chance this will be rectified in > >>>> the near future? > >>> No this is not a priority for me at this stage -- but I'm happy to look > >>> at any workable patches user come up with. > >>> > >>> From the AsciiDoc User Guide: "The current table syntax is overly > >>> complicated and unwieldy to edit, hopefully a more usable syntax will > >>> appear in future versions of AsciiDoc." > >>> > >>> > >>> > >>> > >>>> Anmar > >>>> > >>>> Stuart Rackham wrote: > >>>>> Hi Anmar > >>>>> > >>>>> The current version only allows a paragraph of text in each cell. > >>>>> > >>>>> Cheers, Stuart > >>>> _______________________________________________ > >>>> Asciidoc-discuss mailing list > >>>> Asciidoc-discuss@metaperl.com > >>>> http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss > >>>> > >>> Cheers, Stuart > >> > >> _______________________________________________ > >> Asciidoc-discuss mailing list > >> Asciidoc-discuss@metaperl.com > >> http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss > >> > > > > _______________________________________________ > > Asciidoc-discuss mailing list > > Asciidoc-discuss@metaperl.com > > http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss > > > > Cheers, Stuart > -- > Stuart Rackham > > _______________________________________________ > Asciidoc-discuss mailing list > Asciidoc-discuss@metaperl.com > http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss > _______________________________________________ Asciidoc-discuss mailing list Asciidoc-discuss@metaperl.com http://metaperl.com/cgi-bin/mailman/listinfo/asciidoc-discuss
