Sysadmin Guide - Conversion to asciidocs

[Ryan]

Hi all,

I'm not sure what's going on at all in the fedora docs team atm. As
there has been no communication in IRC, no meetings in recent times,
and no activity until yesterday in pagure everything is looking pretty
dead.

I have therefore begun a conversion to asciidocs for the sysadmin
guide in pagure as a separate project. Apart from the docs-fp-o
project lightly touching on the fact that we want to start making the
documentation topical 'like the gnome project documentation' there is
not any detailed information on how we want to go about this, no
information on the asciidocs tool mallard (and I can't get it to
install to attempt to use it or understand it) and without being able
to communicate with the docs project in IRC I can't really consult
anyone so I feel that the quickest way to get this started is to just
do a 'direct' conversion to asciidocs manually (which i've already
started), and then we can decide how to go about making it topical in
the future, which shouldn't be hard as I'm making my conversion
modular splitting up the different sections of the document into
separate files.

If you want to discuss this with me, I'm logging into IRC fairly
regularly (terminal__) at present, you can send a response to my email
address and the list, or you can comment (I think) on the project at
https://pagure.io/fedora-docs/asciidocs-sysadmin.

Looking forward to hearing from someone.

Ryan.

Docs plans [was Re: Sysadmin Guide - Conversion to asciidocs]

[Matthew Miller]

On Sun, May 21, 2017 at 10:47:33PM +0800, Ryan wrote:
>  I'm not sure what's going on at all in the fedora docs team
> atm. As
>  there has been no communication in IRC, no meetings in recent times,
>  and no activity until yesterday in pagure everything is looking pretty
>  dead. 
Hi Ryan. Yeah, things have really stalled and need to be restarted.
Thanks for jumping in.

I think we have basically three things going on. Not necessarily in
this order:

- What to do about tooling? I think the basic agreement is that we want
  some sort of git-based workflow (ideally including relatively
  lightweight online editing)

- What about information architecture? I think we want something
  primarily search-based, but on the other hand, that can be a
  frustrating experience for users. How do we plan to organize things
  and how do we present that organization in a useful way? How do we
  make sure users find up-to-date and relevant answers?

- What about existing documentation? I personally strongly believe that
  this shouldn't be a blocker. Let's move to something new and start
  building up from there.

- Can we tie in to existing things like ask.fedoraproject.org? (Maybe
  we can even _replace_ that?)

So, hey, everyone! :) What's the plan and what's the process for moving
forward?



-- 
Matthew Miller
<mattdm(a)fedoraproject.org&gt;
Fedora Project Leader

Docs plans [was Re: Sysadmin Guide - Conversion to asciidocs]

[Jean-Baptiste Holcroft]

Le 22/05/2017 à 17:15, Matthew Miller a écrit :
>  Hi Ryan. Yeah, things have really stalled and need to be restarted.
>  Thanks for jumping in.
>
>  I think we have basically three things going on. Not necessarily in
>  this order:
>
>  - What to do about tooling? I think the basic agreement is that we want
>     some sort of git-based workflow (ideally including relatively
>     lightweight online editing)
>
>  - What about information architecture? I think we want something
>     primarily search-based, but on the other hand, that can be a
>     frustrating experience for users. How do we plan to organize things
>     and how do we present that organization in a useful way? How do we
>     make sure users find up-to-date and relevant answers?
>
>  - What about existing documentation? I personally strongly believe that
>     this shouldn't be a blocker. Let's move to something new and start
>     building up from there.
>
>  - Can we tie in to existing things like ask.fedoraproject.org? (Maybe
>     we can even _replace_ that?)
>
>  So, hey, everyone! :) What's the plan and what's the process for moving
>  forward? 
I'm also look for similar information.
Some answer about tooling may be in 
http://www.winglemeyer.org/fedora_docs_proposal/latest/proposal/overview....

This website is the current demonstrator (thank you Brian):
https://budget.fedoraproject.org/index.html

Brian asked me to test translation, so I translated a few strings in 
French in Zanata:
https://fedora.zanata.org/iteration/view/fedora-budget/0.1/languages/fr

I sent a feedback to Brian by email on april 25th but haven't received 
any answer.
I couldn't see a translated version of the website (or may have forgot 
about it).

-- 
Jean-Baptiste Holcroft

Docs plans [was Re: Sysadmin Guide - Conversion to asciidocs]

[Brian Exelbierd]

On Thu, May 25, 2017, at 12:23 AM, Jean-Baptiste Holcroft wrote:
>  Le 22/05/2017 à 17:15, Matthew Miller a écrit :
>  > Hi Ryan. Yeah, things have really stalled and need to be restarted.
>  > Thanks for jumping in.
>  >
>  > I think we have basically three things going on. Not necessarily in
>  > this order:
>  >
>  > - What to do about tooling? I think the basic agreement is that we want
>  >    some sort of git-based workflow (ideally including relatively
>  >    lightweight online editing)
>  >
>  > - What about information architecture? I think we want something
>  >    primarily search-based, but on the other hand, that can be a
>  >    frustrating experience for users. How do we plan to organize things
>  >    and how do we present that organization in a useful way? How do we
>  >    make sure users find up-to-date and relevant answers?
>  >
>  > - What about existing documentation? I personally strongly believe that
>  >    this shouldn't be a blocker. Let's move to something new and start
>  >    building up from there.
>  >
>  > - Can we tie in to existing things like ask.fedoraproject.org? (Maybe
>  >    we can even _replace_ that?)
>  >
>  > So, hey, everyone! :) What's the plan and what's the process for moving
>  > forward?
>  
>  I'm also look for similar information.
>  Some answer about tooling may be in 
>  http://www.winglemeyer.org/fedora_docs_proposal/latest/proposal/overview....
>  
>  This website is the current demonstrator (thank you Brian):
>  https://budget.fedoraproject.org/index.html
>  
>  Brian asked me to test translation, so I translated a few strings in 
>  French in Zanata:
>  https://fedora.zanata.org/iteration/view/fedora-budget/0.1/languages/fr
>  
>  I sent a feedback to Brian by email on april 25th but haven't received 
>  any answer.
>  I couldn't see a translated version of the website (or may have forgot 
>  about it). 
Not forgotten just stuck in the backlog.

I'll keep working on it.

regards,

bex

> 
> -- 
> Jean-Baptiste Holcroft
> _______________________________________________
> docs mailing list -- docs(a)lists.fedoraproject.org
> To unsubscribe send an email to docs-leave(a)lists.fedoraproject.org