Re: Wiki page 'Subprojects' needs some love

[Justin W. Flory]

On 02/20/2018 11:44 PM, Jhoanir Torres wrote:
>  Hi Justin,
>  
>  I saw this wiki page [1] about 'Subprojects' with this message:
>  " This page needs some love
>  This page should be revised or reconstructed to be more helpful.
>  Problems may include being out of step with current team or project
>  status or process. "
>  
>  And I wonder what can I do? in order to give some 'love' to that page.
>  
>  [1] https://fedoraproject.org/wiki/Subprojects
>  
>  
>  Thanks in advance
>   
Hey Jhoanir! I am including the Fedora Docs mailing list in this reply.

This information is mostly a list of all sub-projects with a short
description of each group; I think this content is more valuable for
documentation than it is in the wiki.

There is a page in the docs for this specific wiki page, but it has a
big TODO comment to be completed later.


https://docs.fedoraproject.org/fedora-project/subprojects/subprojects.html

I think the following steps would be good to follow:

  1. Verify wiki page information is accurate / correct
  2. Convert wiki page to AsciiDoc document
  3. Create pull request to Fedora Docs to update the page

This gets the content into our docs and makes it more useful than a
"TODO" comment. We may want to make bigger changes to this page in the
future, but I think it makes more sense to get something up than a blank
page.

I need someone from the Docs team to clarify where this page lives. I
found this, but it's HTML, not an AsciiDoc file.


https://pagure.io/fedora-docs/docs-fp-o/blob/master/f/other-releases-main...

If someone from the docs-side can clarify where this lives, I'm sure
your help to migrate it from the wiki to docs would be helpful.

Are you interested in working on this?

-- 
Cheers,
Justin W. Flory
jflory7(a)gmail.com

Wiki page 'Subprojects' needs some love

[Jhoanir Torres]

El 21 feb. 2018 16:32, "Justin W. Flory" <jflory7(a)gmail.com&gt; escribió:

On 02/20/2018 11:44 PM, Jhoanir Torres wrote:
>  Hi Justin,
>
>  I saw this wiki page [1] about 'Subprojects' with this message:
>  " This page needs some love
>  This page should be revised or reconstructed to be more helpful.
>  Problems may include being out of step with current team or project
>  status or process. "
>
>  And I wonder what can I do? in order to give some 'love' to that page.
>
>  [1] https://fedoraproject.org/wiki/Subprojects
>
>
>  Thanks in advance
>  
Hey Jhoanir! I am including the Fedora Docs mailing list in this reply.

This information is mostly a list of all sub-projects with a short
description of each group; I think this content is more valuable for
documentation than it is in the wiki.

There is a page in the docs for this specific wiki page, but it has a
big TODO comment to be completed later.


https://docs.fedoraproject.org/fedora-project/subprojects/subprojects.html

I think the following steps would be good to follow:

  1. Verify wiki page information is accurate / correct
  2. Convert wiki page to AsciiDoc document
  3. Create pull request to Fedora Docs to update the page

This gets the content into our docs and makes it more useful than a
"TODO" comment. We may want to make bigger changes to this page in the
future, but I think it makes more sense to get something up than a blank
page.

I need someone from the Docs team to clarify where this page lives. I
found this, but it's HTML, not an AsciiDoc file.


https://pagure.io/fedora-docs/docs-fp-o/blob/master/f/other-
releases-main.html

If someone from the docs-side can clarify where this lives, I'm sure
your help to migrate it from the wiki to docs would be helpful.

Are you interested in working on this?



Yes, sure. I can work on this!



--
Cheers,
Justin W. Flory
jflory7(a)gmail.com

Wiki page 'Subprojects' needs some love

[Matthew Miller]

On Wed, Feb 21, 2018 at 11:09:55PM -0500, Jhoanir Torres wrote:
>  I need someone from the Docs team to clarify where this page lives.
> I
>  found this, but it's HTML, not an AsciiDoc file. 
It's here, in the Council docs:

https://pagure.io/Fedora-Council/council-docs/blob/master/f/subprojects


>  If someone from the docs-side can clarify where this lives, I'm
> sure
>  your help to migrate it from the wiki to docs would be helpful. 
Yes. :)

In general, subproject.adoc is the specific replacement for that one
page, but everything in that directory could use an update.


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