Oh!
Thanks. Looks pretty nice. This is something that even me can do.
:-)
Sylvia
On Fri, 2016-09-09 at 14:28 +0100, Simon Clark wrote:
> On 9 September 2016 at 08:34, Sylvia <bhkohane(a)gmail.com> wrote:
> Hello,
>
> > > Sorry for the late reply and maybe I'm going to ask a silly
question but... Is it Mallard a programme or a web based tool...?
> > > If I want to write something... where or how should I
do it? Is
there any specific programmes for it?
>
>
>
> Cheers, and thanks
> Sylvia
>
>
>
>
> On Sun, 2016-09-04 at 17:31 +0530, Tummala Dhanvi wrote:
> > > > > > > > On Thu, Aug 11, 2016 at 7:04 PM, Brian Exelbierd
<bex(a)pobox.com>
wrote:
> > > > > > > This email is to drive some
discussion around $subject. It
follows from
> > > a blog soon to be posted on the Fedora Community blog
> > > > > > > > > > >
(
https://communityblog.fedoraproject.org). The text below is
copied
> > > from that blog:
> > >
> > > Tooling, Tooling, Tooling
> > >
> > > > > > > There was strong consensus around changing to new
tools and
markups. In
> > > > > > > fact, most of the tooling
conversations were held in small
groups near
> > > > > > > the end of the meeting. There was
a desire to continue to see a
drive to
> > > simpler contribution and publication.
> >
> > > > > I also agree with changing to newer tools which makes writing
the
docs
> > a lot simplier.
> >
> > >
> > > > > > > The only significant question was around the
community,
upstream
> > > > > > > adoption and contributor base for
pintail which is the central
tool in
> > > > > > > the new processing flow. People
were very concerned that there
wasn't
> > > > > > > evidence of enough adoption and
contribution to prevent the
project from
> > > > > > > being at risk of going either
unmaintained or slowly
maintained.
> > >
> >
> > First let me briefly explain how the new process works.
> >
> > > > > * Docs are written in AsciiDoc
(
https://en.wikipedia.org/wiki/Asc iiDoc)
> > > > > * Converted to Mallard
(
http://projectmallard.org/)
> > > > > * Publish them using pintail
(
https://github.com/projectmallard/p intail)
> >
> > Docs team had came to this conclusion after considering various
> > > > > alternatives
(
https://communityblog.fedoraproject.org/event-repor t-fedora-docs-fad/,
fad/)
> >
> > > > > AsciiDoc is widely used various projects
(
http://asciidoc.org/#X6 )
n_Mallard)
> >
> > > > > I agree to some extent that there is no enough evidence of
adoption
> > and contribution (Shaun has written 99% of the tools!), but
since
> > > > > Gnome is adopting Mallard we should feel confident to some
extent.
> >
> > > > > If by chance the Mallard goes unmaintained we could also switch
to
> > > > > > > > other tools (like Asciidoctor
http://asciidoctor.org/) for
publishing
> > > > > as we write the docs in Asciidoc format. But
this method reduces
the
> > features that we wanted to use.
> >
> >
> > PS: Brian congrats for becoming Fedora's Community Co-ordinator.
>
>
>
> --
>
> docs mailing list
>
> docs(a)lists.fedoraproject.org
>
> To unsubscribe:
>
> > >
https://lists.fedoraproject.org/admin/lists/docs@lists.fedoraprojec
t.org
Hi Sylvia,
> > Mallard is a markup language for writing topic-based documentation.
The
Ten Minute Tour at
http://projectmallard.org/about/learn/tenminu
tes shows how it works.
Simon
--
docs mailing list
docs(a)lists.fedoraproject.org
To unsubscribe:
>
https://lists.fedoraproject.org/admin/lists/docs@lists.fedoraproject.
org