Big +1 for AsciiDoc

Thanks and regards,
Aditya Sharma

On Tue, 27 Aug 2019 at 23:36, Swapnil M Mane <swapnilmm...@apache.org>
wrote:

> Sure Matt, thank you for the kind note.
> Will surely sync up with you in case of any issue.
> I also played with Asciidoctor in past, indeed a great tool!
>
>
> Best regards,
> Swapnil M Mane,
> www.apache.org
>
> On Tue, Aug 27, 2019 at 11:16 PM Matt Raible <m...@raibledesigns.com>
> wrote:
> >
> > +1 for AsciiDoc! I have a lot of experience with Asciidoctor, so let me
> know if you run into issues.
> >
> > Cheers,
> >
> > Matt
> >
> > > On Aug 27, 2019, at 11:06 AM, Swapnil M Mane <swapnilmm...@apache.org>
> wrote:
> > >
> > > Great, thanks Dave.
> > >
> > > Thoughts travels, while drafting the mail, AsciiDoc was also in my
> mind.
> > > And AsciiDoc is also having all the advantages mentioned above.
> > >
> > > After some more exploration, I am now more inclined towards AsciiDoc.
> > > So, +1 for AsciiDoc.
> > >
> > >
> > > Best regards,
> > > Swapnil M Mane,
> > > www.apache.org
> > >
> > > On Tue, Aug 27, 2019 at 8:53 PM Dave <snoopd...@gmail.com> wrote:
> > >>
> > >> I think that's a great idea and the docs, or a least the screenshots,
> need
> > >> update for the new Roller 6 UI. Markdown is better for this in so many
> > >> ways. AsciiDoc is also a good option but I don't have a strong
> preference
> > >> on Markdown vs. AsciiDoc.
> > >>
> > >> Dave
> > >>
> > >>
> > >> On Tue, Aug 27, 2019 at 10:06 AM Swapnil M Mane <
> swapnilmm...@apache.org>
> > >> wrote:
> > >>
> > >>> Hello team,
> > >>> During my exploration for documentation, I found the documentation
> > >>> link [1] on Roller home page [2] under the Documentation section.
> > >>> I see, currently, we are storing the documents in odt format.
> > >>>
> > >>> I would like to know the thoughts of the community on moving the
> > >>> documentation from .odt to .md
> > >>>
> > >>> We will have the following advantage if we use md format -
> > >>>
> > >>> 1. Rendering support of md file on GitHub
> > >>> The GitHub nicely render the md files, so if the files in md format,
> > >>> it will be easily rendered on GitHub.
> > >>> The odt files don't have any preview on GitHub and it forces the user
> > >>> to download to view the content. (This is annoying for the user and
> > >>> developers ;-)
> > >>> e.g.
> > >>>
> https://github.com/apache/roller/blob/master/docs/roller-template-guide.odt
> > >>>
> > >>> 2. Easy to maintain, the md standard is widely accepted
> > >>> The md format is widely used and this will open up the opportunity
> for
> > >>> new collaborators to participate.
> > >>>
> > >>> Kindly let me know if I am missing any information or history or
> > >>> purpose for maintaining our docs in .odt format.
> > >>>
> > >>> P.S. I see we are also maintaining the pdf version of odt [3] in
> master
> > >>> branch.
> > >>> The conversion from md to pdf is also doable.
> > >>> IMO, if we move our documents to md version, the pdf conversation
> will
> > >>> be no longer required since it will be rendered on GitHub properly.
> > >>> (Still, if I am missing anything, please feel free to comment :-)
> > >>>
> > >>> [1] https://github.com/apache/roller/tree/roller-5.2.0/docs
> > >>> [2] http://roller.apache.org/
> > >>> [3] https://github.com/apache/roller/tree/master/docs
> > >>>
> > >>> Best regards,
> > >>> Swapnil M Mane,
> > >>> www.apache.org
> > >>>
> >
>

Reply via email to