[WIKI] Contribute and DevelTips are duplicate

[Petr Cech]

Hi,

I've read the wiki according to
#  https://fedorahosted.org/sssd/ticket/2706
and I think that it could be helpful clean the page
#  https://fedorahosted.org/sssd/wiki/DevelTutorials
from "git topic" and create new page for everything related to git.

The motivation is, that:
* Contribute briefly describe whole process on basic level,
* DevelTips looks like How To,
* DevelTutorials are more about technologies, libraries, build process...,
* So there could be one page for everything about git.

--------------------------------------------------------------------------------
NOTES how we could edit wiki:
--------------------------------------------------------------------------------
https://fedorahosted.org/sssd/wiki/Contribute

Contribute
         Contribution Policy
         Source Code Repository  /*
                                  * There could be only a link to the 
repo and
                                  * reference to "New Git page".
                                  */
             Tips and tricks for developers
         QA, Development and Bug Triage
             Development Repositories
         Localization and Internationalization
         Design Pages
     Credits
     Latest Documentation and Presentations

https://fedorahosted.org/sssd/wiki/DevelTips

SSSD Devel page
         Are there any introductory tutorials available?
             /* + Reference to the new "Git page" */
         When I debug an SSSD process in a debugger, it always gets 
killed with …
         Using valgrind to identify memory access problems
         Using strace to track the SSSD processes
         How do I track work-in-progress of other developers?  /*
* Is it
* still valid?
*
* I tried link
* for jhrozek and
* his sssd.git
* and the url
* doesn't exist.
*/
         Why does make check take so long?
         Using clang to perform static analysis of source code
         When I compile the SSSD from source there is an error that says …

https://fedorahosted.org/sssd/wiki/DevelTutorials

/*
      * Label @new-git-page means
      * that I would like move given paragraph to the "New git page"
      */

Talloc
     Tevent and tevent_req
     Coding Style
     Code Contributions               /* @new-git-page */
         Getting the source           /* @new-git-page */
         Building SSSD for development and debugging
         Unit tests
         Submitting a patch upstream  /* @new-git-page */
         Patch metadata               /* @new-git-page */
     Translation Contributions
     Devel Tips

"New Git page" /* Maybe Git Tips? */

+ paragraph about git setup from Contribute->Source Code Repository
     + some paragraphs of DevelTutorials->Code Contributions
--------------------------------------------------------------------------------

I am looking forward your opinions.

Petr

[Jakub Hrozek]

On Fri, Jul 10, 2015 at 10:38:09AM +0200, Petr Cech wrote:
> Hi,

Hi,

sorry about the vacation-induced delay. This is a very useful proposal,
see inline for my comments.
> I've read the wiki according to
> #  https://fedorahosted.org/sssd/ticket/2706
> and I think that it could be helpful clean the page
> #  https://fedorahosted.org/sssd/wiki/DevelTutorials
> from "git topic" and create new page for everything related to git.
>
> The motivation is, that:
> Contribute briefly describe whole process on basic level,
> DevelTips looks like How To,
> DevelTutorials are more about technologies, libraries, build process...,
> So there could be one page for everything about git.

~~~~~~~~~
I think there might be one (or two) page about our development process in,
not neccesarrily git.

As a general comment, my aim when I filed this ticket was to make our
wiki more maintanable. We have too many tasks on our hands already, so
we should make sure all the info on our wiki is up-to-date and if
possible, we have a documented way to update them (maybe in the release
process...perhaps we could say that with every .0 version we update a
selected list of pages?)
> NOTES how we could edit wiki:
>
> https://fedorahosted.org/sssd/wiki/Contribute
> Contribute
>     Contribution Policy
>     Source Code Repository  /*
>                              * There could be only a link to the repo
>
> and
>                                  * reference to "New Git page".

The new git page is actually my main concern, see below.
>                              */
>         Tips and tricks for developers
>     QA, Development and Bug Triage

Hmm, I see another duplication, we have both
    https://fedorahosted.org/sssd/wiki/BugLifecycle
and:
    https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
(the latter being my fault)

Can you also take a look at these two with your fresh eyes and consider
merging them?
>         Development Repositories

We should add a note to this section linking to Lukas' COPR repo. I was
even considering adding a link to this repo to both the Releases page
and even maybe the front page -- opinions are welcome here!
>     Localization and Internationalization

This section needs fixing, we don't use transifex anymore but Zanata.
See the ReleaseProcess page for some more details:
    https://fedorahosted.org/sssd/wiki/ReleaseProcess

I think a link to Zanata would be enough here. But at the same time, I
would prefer this section to stay.
>     Design Pages

I think this whole section needs to go. We're adding several new design
pages each release so it's not realistic to maintain this page. In order
to track a design, I think the ultimate source is the ticket.

If we want to maintain a section listing open/closed/postponed designs,
then I would prefer to generate them from Trac ticket status. But IMO
it's better to not have this info at all rather than have outdated
info...
> Credits

To be honest, I don't think this section and the page it links to:
    https://fedorahosted.org/sssd/wiki/WhoAreWe
is useful and I would vote to remove it. Please note I'm not diminishing
the contributions especially for non-Red Hat people, but I also think
that since we don't really maintain the page, it would be better to
remove it.

The development team info is outdated at least since 2012..
> Latest Documentation and Presentations

I think the documentation is very valuable and needs to stay. Maybe we
could add a sentence saying something like "There is a dedicated page
where we keep our documentation".
> https://fedorahosted.org/sssd/wiki/DevelTips

This page is rather short, what do you say we merge it with Contribute
page?
> SSSD Devel page
>     Are there any introductory tutorials available?
>         /* + Reference to the new "Git page" */
>     When I debug an SSSD process in a debugger, it always gets killed
>
> with …
>         Using valgrind to identify memory access problems
>         Using strace to track the SSSD processes
>         How do I track work-in-progress of other developers?  /*
> Is it
> still valid?
> I tried link
> for jhrozek and
> his sssd.git
> and the url
> doesn't exist.
>
> */

Hmm, which link did you try? I keep my work here these days:
    https://fedorapeople.org/cgit/jhrozek/public_git/sssd.git
or as a git fetch URL:
    git://fedorapeople.org/home/fedora/jhrozek/public_git/sssd.git
>     Why does make check take so long?
>     Using clang to perform static analysis of source code
>     When I compile the SSSD from source there is an error that says …
>
>
> https://fedorahosted.org/sssd/wiki/DevelTutorials
> /*
>  * Label @new-git-page means
>  * that I would like move given paragraph to the "New git page"
>  */
>
> Talloc
> Tevent and tevent_req
> Coding Style
> Code Contributions               /* @new-git-page */
>     Getting the source           /* @new-git-page */
>     Building SSSD for development and debugging
>     Unit tests
>     Submitting a patch upstream  /* @new-git-page */
>     Patch metadata               /* @new-git-page */

Why do you think we should have one more page and not add the sections
to Contribute? What if we only had Contribute and DevelTips, then we'd
have one page for people who are starting with SSSD development and one
for people who are debugging or need some special advice.
> Translation Contributions
> Devel Tips

These two should be merged elsewhere IMO. I think linking Zanata and the
DevelTips page from the Contribute page might be a good first step.
> "New Git page" /* Maybe Git Tips? */
> + paragraph about git setup from Contribute->Source Code Repository
> + some paragraphs of DevelTutorials->Code Contributions
>
> I am looking forward your opinions.
>
> Petr
> _______________________________________________
> sssd-devel mailing list
> [e-mail]
> https://lists.fedorahosted.org/mailman/listinfo/sssd-devel

[Petr Cech]

On 07/13/2015 11:02 PM, Jakub Hrozek wrote:
> On Fri, Jul 10, 2015 at 10:38:09AM +0200, Petr Cech wrote:
> > Hi,
>
> Hi,
>
> sorry about the vacation-induced delay. This is a very useful proposal,
> see inline for my comments.
> > I've read the wiki according to
> > #  https://fedorahosted.org/sssd/ticket/2706
> > and I think that it could be helpful clean the page
> > #  https://fedorahosted.org/sssd/wiki/DevelTutorials
> > from "git topic" and create new page for everything related to git.
> >
> > The motivation is, that:
> > Contribute briefly describe whole process on basic level,
> > DevelTips looks like How To,
> > DevelTutorials are more about technologies, libraries, build process...,
> > So there could be one page for everything about git.
>                                            ~~~~~~~~~
>
> I think there might be one (or two) page about our development process in,
> not neccesarrily git.
>
> As a general comment, my aim when I filed this ticket was to make our
> wiki more maintanable. We have too many tasks on our hands already, so
> we should make sure all the info on our wiki is up-to-date and if
> possible, we have a documented way to update them (maybe in the release
> process...perhaps we could say that with every .0 version we update a
> selected list of pages?)
> > NOTES how we could edit wiki:
> >
> > https://fedorahosted.org/sssd/wiki/Contribute
> >  Contribute
> >      Contribution Policy
> >      Source Code Repository  /*
> >                               * There could be only a link to the repo
> >
> > and
> >                                   * reference to "New Git page".
>
> The new git page is actually my main concern, see below.
> >                               */
> >          Tips and tricks for developers
> >      QA, Development and Bug Triage
>
> Hmm, I see another duplication, we have both
>      https://fedorahosted.org/sssd/wiki/BugLifecycle
> and:
>      https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
> (the latter being my fault)
>
> Can you also take a look at these two with your fresh eyes and consider
> merging them?
> >          Development Repositories
>
> We should add a note to this section linking to Lukas' COPR repo. I was
> even considering adding a link to this repo to both the Releases page
> and even maybe the front page -- opinions are welcome here!
> >      Localization and Internationalization
>
> This section needs fixing, we don't use transifex anymore but Zanata.
> See the ReleaseProcess page for some more details:
>      https://fedorahosted.org/sssd/wiki/ReleaseProcess
>
> I think a link to Zanata would be enough here. But at the same time, I
> would prefer this section to stay.
> >      Design Pages
>
> I think this whole section needs to go. We're adding several new design
> pages each release so it's not realistic to maintain this page. In order
> to track a design, I think the ultimate source is the ticket.
>
> If we want to maintain a section listing open/closed/postponed designs,
> then I would prefer to generate them from Trac ticket status. But IMO
> it's better to not have this info at all rather than have outdated
> info...
> >  Credits
>
> To be honest, I don't think this section and the page it links to:
>      https://fedorahosted.org/sssd/wiki/WhoAreWe
> is useful and I would vote to remove it. Please note I'm not diminishing
> the contributions especially for non-Red Hat people, but I also think
> that since we don't really maintain the page, it would be better to
> remove it.
>
> The development team info is outdated at least since 2012..
> >  Latest Documentation and Presentations
>
> I think the documentation is very valuable and needs to stay. Maybe we
> could add a sentence saying something like "There is a dedicated page
> where we keep our documentation".
> > https://fedorahosted.org/sssd/wiki/DevelTips
>
> This page is rather short, what do you say we merge it with Contribute
> page?
> >  SSSD Devel page
> >      Are there any introductory tutorials available?
> >          /* + Reference to the new "Git page" */
> >      When I debug an SSSD process in a debugger, it always gets killed
> >
> > with …
> >          Using valgrind to identify memory access problems
> >          Using strace to track the SSSD processes
> >          How do I track work-in-progress of other developers?  /*
> > Is it
> > still valid?
> > I tried link
> > for jhrozek and
> > his sssd.git
> > and the url
> > doesn't exist.
> >
> > */
>
> Hmm, which link did you try? I keep my work here these days:
>      https://fedorapeople.org/cgit/jhrozek/public_git/sssd.git
> or as a git fetch URL:
>      git://fedorapeople.org/home/fedora/jhrozek/public_git/sssd.git
> >      Why does make check take so long?
> >      Using clang to perform static analysis of source code
> >      When I compile the SSSD from source there is an error that says …
> >
> >
> > https://fedorahosted.org/sssd/wiki/DevelTutorials
> >  /*
> >   * Label @new-git-page means
> >   * that I would like move given paragraph to the "New git page"
> >   */
> >
> >  Talloc
> >  Tevent and tevent_req
> >  Coding Style
> >  Code Contributions               /* @new-git-page */
> >      Getting the source           /* @new-git-page */
> >      Building SSSD for development and debugging
> >      Unit tests
> >      Submitting a patch upstream  /* @new-git-page */
> >      Patch metadata               /* @new-git-page */
>
> Why do you think we should have one more page and not add the sections
> to Contribute? What if we only had Contribute and DevelTips, then we'd
> have one page for people who are starting with SSSD development and one
> for people who are debugging or need some special advice.
> >  Translation Contributions
> >  Devel Tips
>
> These two should be merged elsewhere IMO. I think linking Zanata and the
> DevelTips page from the Contribute page might be a good first step.
> > "New Git page" /* Maybe Git Tips? */
> >  + paragraph about git setup from Contribute->Source Code Repository
> >  + some paragraphs of DevelTutorials->Code Contributions
> >
> > I am looking forward your opinions.
> >
> > Petr
> > _______________________________________________
> > sssd-devel mailing list
> > [e-mail]
> > https://lists.fedorahosted.org/mailman/listinfo/sssd-devel
>
> sssd-devel mailing list
> [e-mail]
> https://lists.fedorahosted.org/mailman/listinfo/sssd-devel

Hi,

I have read the wiki pages. And I have the edited version. It would be 
difficult to send the diff, so I started a new pages where you can view 
the result.

Original pages:
[ 1] https://fedorahosted.org/sssd/wiki/Contribute
[ 2] https://fedorahosted.org/sssd/wiki/DevelTips
[ 3] https://fedorahosted.org/sssd/wiki/DevelTutorials
[ 4] https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
[ 5] https://fedorahosted.org/sssd/wiki/BugLifecycle
[ 6] https://fedorahosted.org/sssd/wiki/Repositories

Content of [3] has been divided between [1] and [3], content of [5] has 
been divided between [1] and [4]. Then [3,5,6] will be deleted.

Test of new pages:
[ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
[ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
[ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs

Note that the links lead to the original pages.
At [7] you can find "COPR Repository" section, but I am not sure with 
text here. Please look at it.
I did not pass the whole wiki. I think there might be a link from [8] 
(perhaps [9]) on Troubleshooting.

I look forward to your comments, I need the opinions of another persons.

Petr

[Petr Cech]

On 07/17/2015 01:26 PM, Petr Cech wrote:
> Hi,
>
> I have read the wiki pages. And I have the edited version. It would be 
> difficult to send the diff, so I started a new pages where you can 
> view the result.
>
> Original pages:
> [ 1] https://fedorahosted.org/sssd/wiki/Contribute
> [ 2] https://fedorahosted.org/sssd/wiki/DevelTips
> [ 3] https://fedorahosted.org/sssd/wiki/DevelTutorials
> [ 4] https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
> [ 5] https://fedorahosted.org/sssd/wiki/BugLifecycle
> [ 6] https://fedorahosted.org/sssd/wiki/Repositories
>
> Content of [3] has been divided between [1] and [3], content of [5] 
> has been divided between [1] and [4]. Then [3,5,6] will be deleted.
>
> Test of new pages:
> [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
>
> Note that the links lead to the original pages.
> At [7] you can find "COPR Repository" section, but I am not sure with 
> text here. Please look at it.
> I did not pass the whole wiki. I think there might be a link from [8] 
> (perhaps [9]) on Troubleshooting.
>
> I look forward to your comments, I need the opinions of another persons.
>
> Petr

Hi,

a did some little edits according to talk with Jakub:
   * deleting Code Submission Process in Contribute
   * simplifying the structure of the headings in Contribute
   * adding link to tevent documentation in Devel tips
   * merging SSSD bug report
and we would like to move link to COPR repo to the homepage (and add 
note about Ubuntu package, is it right?)

So new version (without homepage and link to Ubuntu repo) is on the same 
place:
[ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
[ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
[ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs

Petr

[Michal Židek]

On 08/17/2015 02:21 PM, Petr Cech wrote:
> On 07/17/2015 01:26 PM, Petr Cech wrote:
> > Hi,
> >
> > I have read the wiki pages. And I have the edited version. It would be
> > difficult to send the diff, so I started a new pages where you can
> > view the result.
> >
> > Original pages:
> > [ 1] https://fedorahosted.org/sssd/wiki/Contribute
> > [ 2] https://fedorahosted.org/sssd/wiki/DevelTips
> > [ 3] https://fedorahosted.org/sssd/wiki/DevelTutorials
> > [ 4] https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
> > [ 5] https://fedorahosted.org/sssd/wiki/BugLifecycle
> > [ 6] https://fedorahosted.org/sssd/wiki/Repositories
> >
> > Content of [3] has been divided between [1] and [3], content of [5]
> > has been divided between [1] and [4]. Then [3,5,6] will be deleted.
> >
> > Test of new pages:
> > [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> > [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> > [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
> >
> > Note that the links lead to the original pages.
> > At [7] you can find "COPR Repository" section, but I am not sure with
> > text here. Please look at it.
> > I did not pass the whole wiki. I think there might be a link from [8]
> > (perhaps [9]) on Troubleshooting.
> >
> > I look forward to your comments, I need the opinions of another persons.
> >
> > Petr
>
> Hi,
>
> a did some little edits according to talk with Jakub:
> deleting Code Submission Process in Contribute
> simplifying the structure of the headings in Contribute
> adding link to tevent documentation in Devel tips
> merging SSSD bug report
>
> and we would like to move link to COPR repo to the homepage (and add
> note about Ubuntu package, is it right?)
>
> So new version (without homepage and link to Ubuntu repo) is on the same
> place:
> [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
>
> Petr

Hi!

I think that Petr's changes to Wiki are improvement over the
current state. He removes a lot of duplicated and outdated
info. So if nobody objects I would like Petr to go ahead
and replace the current pages with the new ones.

I have one comment: Does somebody know how to move the
table of contents to the left? Currently it is in the upper
right corner and I think (especially on bigger monitors)
it is really not easy to spot. The table is IMO very important
and gives good outline of what to expect from the page
so I would really like to have it on the left nice and
visible.

Also I like the idea of revisiting the wiki pages regularly
in order to further improve them and keep them up-to-date.
I think the overall navigation on our wiki has room for
improvement, but we do not need to do everything at once.

Michal

[Jakub Hrozek]

On Wed, Sep 02, 2015 at 05:18:24PM +0200, Michal Židek wrote:
> On 08/17/2015 02:21 PM, Petr Cech wrote:
> > On 07/17/2015 01:26 PM, Petr Cech wrote:
> > > Hi,
> > >
> > > I have read the wiki pages. And I have the edited version. It would be
> > > difficult to send the diff, so I started a new pages where you can
> > > view the result.
> > >
> > > Original pages:
> > > [ 1] https://fedorahosted.org/sssd/wiki/Contribute
> > > [ 2] https://fedorahosted.org/sssd/wiki/DevelTips
> > > [ 3] https://fedorahosted.org/sssd/wiki/DevelTutorials
> > > [ 4] https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
> > > [ 5] https://fedorahosted.org/sssd/wiki/BugLifecycle
> > > [ 6] https://fedorahosted.org/sssd/wiki/Repositories
> > >
> > > Content of [3] has been divided between [1] and [3], content of [5]
> > > has been divided between [1] and [4]. Then [3,5,6] will be deleted.
> > >
> > > Test of new pages:
> > > [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> > > [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> > > [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
> > >
> > > Note that the links lead to the original pages.
> > > At [7] you can find "COPR Repository" section, but I am not sure with
> > > text here. Please look at it.
> > > I did not pass the whole wiki. I think there might be a link from [8]
> > > (perhaps [9]) on Troubleshooting.
> > >
> > > I look forward to your comments, I need the opinions of another persons.
> > >
> > > Petr
> >
> > Hi,
> >
> > a did some little edits according to talk with Jakub:
> > deleting Code Submission Process in Contribute
> > simplifying the structure of the headings in Contribute
> > adding link to tevent documentation in Devel tips
> > merging SSSD bug report
> >
> > and we would like to move link to COPR repo to the homepage (and add
> > note about Ubuntu package, is it right?)
> >
> > So new version (without homepage and link to Ubuntu repo) is on the same
> > place:
> > [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> > [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> > [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
> >
> > Petr
>
> Hi!
>
> I think that Petr's changes to Wiki are improvement over the
> current state. He removes a lot of duplicated and outdated
> info. So if nobody objects I would like Petr to go ahead
> and replace the current pages with the new ones.

Thank you very much for review, they looked good to me as well when we
discussed the changes in person last time.

Petr, please move the pages and then send a mail to the list about the
update, we can always change more stuff or even roll back.
> I have one comment: Does somebody know how to move the
> table of contents to the left? Currently it is in the upper
> right corner and I think (especially on bigger monitors)
> it is really not easy to spot. The table is IMO very important
> and gives good outline of what to expect from the page
> so I would really like to have it on the left nice and
> visible.

I only found http://trac.edgewall.org/wiki/PageOutline about the macro.
> Also I like the idea of revisiting the wiki pages regularly
> in order to further improve them and keep them up-to-date.
> I think the overall navigation on our wiki has room for
> improvement, but we do not need to do everything at once.

Hmm I guess I missed that how exactly are we going to update them
regularly? (I agree we should, I'm just interested in the mechanics)

[Michal Židek]

On 09/02/2015 05:47 PM, Jakub Hrozek wrote:
> On Wed, Sep 02, 2015 at 05:18:24PM +0200, Michal Židek wrote:
> > On 08/17/2015 02:21 PM, Petr Cech wrote:
> > > On 07/17/2015 01:26 PM, Petr Cech wrote:
> > > > Hi,
> > > >
> > > > I have read the wiki pages. And I have the edited version. It would be
> > > > difficult to send the diff, so I started a new pages where you can
> > > > view the result.
> > > >
> > > > Original pages:
> > > > [ 1] https://fedorahosted.org/sssd/wiki/Contribute
> > > > [ 2] https://fedorahosted.org/sssd/wiki/DevelTips
> > > > [ 3] https://fedorahosted.org/sssd/wiki/DevelTutorials
> > > > [ 4] https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
> > > > [ 5] https://fedorahosted.org/sssd/wiki/BugLifecycle
> > > > [ 6] https://fedorahosted.org/sssd/wiki/Repositories
> > > >
> > > > Content of [3] has been divided between [1] and [3], content of [5]
> > > > has been divided between [1] and [4]. Then [3,5,6] will be deleted.
> > > >
> > > > Test of new pages:
> > > > [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> > > > [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> > > > [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
> > > >
> > > > Note that the links lead to the original pages.
> > > > At [7] you can find "COPR Repository" section, but I am not sure with
> > > > text here. Please look at it.
> > > > I did not pass the whole wiki. I think there might be a link from [8]
> > > > (perhaps [9]) on Troubleshooting.
> > > >
> > > > I look forward to your comments, I need the opinions of another persons.
> > > >
> > > > Petr
> > >
> > > Hi,
> > >
> > > a did some little edits according to talk with Jakub:
> > > deleting Code Submission Process in Contribute
> > > simplifying the structure of the headings in Contribute
> > > adding link to tevent documentation in Devel tips
> > > merging SSSD bug report
> > >
> > > and we would like to move link to COPR repo to the homepage (and add
> > > note about Ubuntu package, is it right?)
> > >
> > > So new version (without homepage and link to Ubuntu repo) is on the same
> > > place:
> > > [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> > > [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> > > [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
> > >
> > > Petr
> >
> > Hi!
> >
> > I think that Petr's changes to Wiki are improvement over the
> > current state. He removes a lot of duplicated and outdated
> > info. So if nobody objects I would like Petr to go ahead
> > and replace the current pages with the new ones.
>
> Thank you very much for review, they looked good to me as well when we
> discussed the changes in person last time.
>
> Petr, please move the pages and then send a mail to the list about the
> update, we can always change more stuff or even roll back.
> > I have one comment: Does somebody know how to move the
> > table of contents to the left? Currently it is in the upper
> > right corner and I think (especially on bigger monitors)
> > it is really not easy to spot. The table is IMO very important
> > and gives good outline of what to expect from the page
> > so I would really like to have it on the left nice and
> > visible.
>
> I only found http://trac.edgewall.org/wiki/PageOutline about the macro.
> > Also I like the idea of revisiting the wiki pages regularly
> > in order to further improve them and keep them up-to-date.
> > I think the overall navigation on our wiki has room for
> > improvement, but we do not need to do everything at once.
>
> Hmm I guess I missed that how exactly are we going to update them
> regularly? (I agree we should, I'm just interested in the mechanics)

We did not agree on the mechanics yet. We could make it part
of release cycle. I would also not be against filing tickets
with titles like: "Review and update wiki pages for 1.14.1".
This would force us to look at the wiki at least once per
release (or every major version release). I am not sure if
this is good idea, but we can change the mechanics any time.

Michal

[Jakub Hrozek]

On Wed, Sep 02, 2015 at 06:08:51PM +0200, Michal Židek wrote:
> On 09/02/2015 05:47 PM, Jakub Hrozek wrote:
> > On Wed, Sep 02, 2015 at 05:18:24PM +0200, Michal Židek wrote:
> > > On 08/17/2015 02:21 PM, Petr Cech wrote:
> > > > On 07/17/2015 01:26 PM, Petr Cech wrote:
> > > > > Hi,
> > > > >
> > > > > I have read the wiki pages. And I have the edited version. It would be
> > > > > difficult to send the diff, so I started a new pages where you can
> > > > > view the result.
> > > > >
> > > > > Original pages:
> > > > > [ 1] https://fedorahosted.org/sssd/wiki/Contribute
> > > > > [ 2] https://fedorahosted.org/sssd/wiki/DevelTips
> > > > > [ 3] https://fedorahosted.org/sssd/wiki/DevelTutorials
> > > > > [ 4] https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
> > > > > [ 5] https://fedorahosted.org/sssd/wiki/BugLifecycle
> > > > > [ 6] https://fedorahosted.org/sssd/wiki/Repositories
> > > > >
> > > > > Content of [3] has been divided between [1] and [3], content of [5]
> > > > > has been divided between [1] and [4]. Then [3,5,6] will be deleted.
> > > > >
> > > > > Test of new pages:
> > > > > [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> > > > > [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> > > > > [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
> > > > >
> > > > > Note that the links lead to the original pages.
> > > > > At [7] you can find "COPR Repository" section, but I am not sure with
> > > > > text here. Please look at it.
> > > > > I did not pass the whole wiki. I think there might be a link from [8]
> > > > > (perhaps [9]) on Troubleshooting.
> > > > >
> > > > > I look forward to your comments, I need the opinions of another persons.
> > > > >
> > > > > Petr
> > > >
> > > > Hi,
> > > >
> > > > a did some little edits according to talk with Jakub:
> > > > deleting Code Submission Process in Contribute
> > > > simplifying the structure of the headings in Contribute
> > > > adding link to tevent documentation in Devel tips
> > > > merging SSSD bug report
> > > >
> > > > and we would like to move link to COPR repo to the homepage (and add
> > > > note about Ubuntu package, is it right?)
> > > >
> > > > So new version (without homepage and link to Ubuntu repo) is on the same
> > > > place:
> > > > [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> > > > [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> > > > [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
> > > >
> > > > Petr
> > >
> > > Hi!
> > >
> > > I think that Petr's changes to Wiki are improvement over the
> > > current state. He removes a lot of duplicated and outdated
> > > info. So if nobody objects I would like Petr to go ahead
> > > and replace the current pages with the new ones.
> >
> > Thank you very much for review, they looked good to me as well when we
> > discussed the changes in person last time.
> >
> > Petr, please move the pages and then send a mail to the list about the
> > update, we can always change more stuff or even roll back.
> > > I have one comment: Does somebody know how to move the
> > > table of contents to the left? Currently it is in the upper
> > > right corner and I think (especially on bigger monitors)
> > > it is really not easy to spot. The table is IMO very important
> > > and gives good outline of what to expect from the page
> > > so I would really like to have it on the left nice and
> > > visible.
> >
> > I only found http://trac.edgewall.org/wiki/PageOutline about the macro.
> > > Also I like the idea of revisiting the wiki pages regularly
> > > in order to further improve them and keep them up-to-date.
> > > I think the overall navigation on our wiki has room for
> > > improvement, but we do not need to do everything at once.
> >
> > Hmm I guess I missed that how exactly are we going to update them
> > regularly? (I agree we should, I'm just interested in the mechanics)
>
> We did not agree on the mechanics yet. We could make it part
> of release cycle.

OK, can you add it as another action item to the ReleaseProcess page? It
would also help to list the pages that need to be checked or at least
the wiki category.
> I would also not be against filing tickets
> with titles like: "Review and update wiki pages for 1.14.1".
> This would force us to look at the wiki at least once per
> release (or every major version release). I am not sure if
> this is good idea, but we can change the mechanics any time.

Feel free to file one for 1.13.2 and 1.14 beta as blocker tasks. Feel
free to bypass triage.

[Petr Cech]

On 09/02/2015 05:47 PM, Jakub Hrozek wrote:
> On Wed, Sep 02, 2015 at 05:18:24PM +0200, Michal Židek wrote:
> > On 08/17/2015 02:21 PM, Petr Cech wrote:
> > > On 07/17/2015 01:26 PM, Petr Cech wrote:
> > > > Hi,
> > > >
> > > > I have read the wiki pages. And I have the edited version. It would be
> > > > difficult to send the diff, so I started a new pages where you can
> > > > view the result.
> > > >
> > > > Original pages:
> > > > [ 1] https://fedorahosted.org/sssd/wiki/Contribute
> > > > [ 2] https://fedorahosted.org/sssd/wiki/DevelTips
> > > > [ 3] https://fedorahosted.org/sssd/wiki/DevelTutorials
> > > > [ 4] https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
> > > > [ 5] https://fedorahosted.org/sssd/wiki/BugLifecycle
> > > > [ 6] https://fedorahosted.org/sssd/wiki/Repositories
> > > >
> > > > Content of [3] has been divided between [1] and [3], content of [5]
> > > > has been divided between [1] and [4]. Then [3,5,6] will be deleted.
> > > >
> > > > Test of new pages:
> > > > [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> > > > [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> > > > [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
> > > >
> > > > Note that the links lead to the original pages.
> > > > At [7] you can find "COPR Repository" section, but I am not sure with
> > > > text here. Please look at it.
> > > > I did not pass the whole wiki. I think there might be a link from [8]
> > > > (perhaps [9]) on Troubleshooting.
> > > >
> > > > I look forward to your comments, I need the opinions of another persons.
> > > >
> > > > Petr
> > >
> > > Hi,
> > >
> > > a did some little edits according to talk with Jakub:
> > > deleting Code Submission Process in Contribute
> > > simplifying the structure of the headings in Contribute
> > > adding link to tevent documentation in Devel tips
> > > merging SSSD bug report
> > >
> > > and we would like to move link to COPR repo to the homepage (and add
> > > note about Ubuntu package, is it right?)
> > >
> > > So new version (without homepage and link to Ubuntu repo) is on the same
> > > place:
> > > [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> > > [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> > > [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
> > >
> > > Petr
> >
> > Hi!
> >
> > I think that Petr's changes to Wiki are improvement over the
> > current state. He removes a lot of duplicated and outdated
> > info. So if nobody objects I would like Petr to go ahead
> > and replace the current pages with the new ones.
>
> Thank you very much for review, they looked good to me as well when we
> discussed the changes in person last time.
>
> Petr, please move the pages and then send a mail to the list about the
> update, we can always change more stuff or even roll back.

I just updated the wiki pages. I will send another mail for it.

But in this thread, I would like to note, what is exactly done.

Original pages:
[ 1] https://fedorahosted.org/sssd/wiki/Contribute
[ 2] https://fedorahosted.org/sssd/wiki/DevelTips
[ 3] https://fedorahosted.org/sssd/wiki/DevelTutorials
[ 4] https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
[ 5] https://fedorahosted.org/sssd/wiki/BugLifecycle
[ 6] https://fedorahosted.org/sssd/wiki/Repositories

Content of [3] has been divided between [1] and [3], content of [5]
has been divided between [1] and [4]. Then [3,5,6] will be deleted.

Test of new pages:
[ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
[ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
[ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs

UPDATE:
[ 7] --> [ 1]
[ 8] --> [ 2]
[ 9] --> [ 4]
Pages [7,8,9] exist still, but we could remove it.
Pages [3,5,6] exist too, but I hope, no links target them. We could
remove it too.

I am sorry, but after this ticket I am blind on wiki. Could somebody 
check, that I did update properly? Thanks.

Petr
> > I have one comment: Does somebody know how to move the
> > table of contents to the left? Currently it is in the upper
> > right corner and I think (especially on bigger monitors)
> > it is really not easy to spot. The table is IMO very important
> > and gives good outline of what to expect from the page
> > so I would really like to have it on the left nice and
> > visible.
>
> I only found http://trac.edgewall.org/wiki/PageOutline about the macro.
> > Also I like the idea of revisiting the wiki pages regularly
> > in order to further improve them and keep them up-to-date.
> > I think the overall navigation on our wiki has room for
> > improvement, but we do not need to do everything at once.
>
> Hmm I guess I missed that how exactly are we going to update them
> regularly? (I agree we should, I'm just interested in the mechanics)
> _______________________________________________
> sssd-devel mailing list
> [e-mail]
> https://lists.fedorahosted.org/mailman/listinfo/sssd-devel

[Petr Cech]

On 09/03/2015 04:02 PM, Petr Cech wrote:
> I just updated the wiki pages. I will send another mail for it.
>
> But in this thread, I would like to note, what is exactly done.
>
> Original pages:
> [ 1] https://fedorahosted.org/sssd/wiki/Contribute
> [ 2] https://fedorahosted.org/sssd/wiki/DevelTips
> [ 3] https://fedorahosted.org/sssd/wiki/DevelTutorials
> [ 4] https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
> [ 5] https://fedorahosted.org/sssd/wiki/BugLifecycle
> [ 6] https://fedorahosted.org/sssd/wiki/Repositories
>
> Content of [3] has been divided between [1] and [3], content of [5]
> has been divided between [1] and [4]. Then [3,5,6] will be deleted.

There is a little mistake, content of [3] has been divided between [2,4] 
I just checked it.
> Test of new pages:
> [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
>
> UPDATE:
> [ 7] --> [ 1]
> [ 8] --> [ 2]
> [ 9] --> [ 4]
> Pages [7,8,9] exist still, but we could remove it.
> Pages [3,5,6] exist too, but I hope, no links target them. We could
> remove it too.
>
> I am sorry, but after this ticket I am blind on wiki. Could somebody
> check, that I did update properly? Thanks.
>
> Petr

Hi,

some time ago I edited wiki pages. The exact changes are described in 
the previous email.
Today I erased the pages ([7,8,9] and [3,5,6]) that were marked for 
deletion. Its copies is attached.

Regards

Petr

[Michal Židek]

On 10/06/2015 12:38 PM, Petr Cech wrote:
> On 09/03/2015 04:02 PM, Petr Cech wrote:
> > I just updated the wiki pages. I will send another mail for it.
> >
> > But in this thread, I would like to note, what is exactly done.
> >
> > Original pages:
> > [ 1] https://fedorahosted.org/sssd/wiki/Contribute
> > [ 2] https://fedorahosted.org/sssd/wiki/DevelTips
> > [ 3] https://fedorahosted.org/sssd/wiki/DevelTutorials
> > [ 4] https://fedorahosted.org/sssd/wiki/Reporting_sssd_bugs
> > [ 5] https://fedorahosted.org/sssd/wiki/BugLifecycle
> > [ 6] https://fedorahosted.org/sssd/wiki/Repositories
> >
> > Content of [3] has been divided between [1] and [3], content of [5]
> > has been divided between [1] and [4]. Then [3,5,6] will be deleted.
>
> There is a little mistake, content of [3] has been divided between [2,4]
> I just checked it.
> > Test of new pages:
> > [ 7] https://fedorahosted.org/sssd/wiki/pcech_test_contribute
> > [ 8] https://fedorahosted.org/sssd/wiki/pcech_test_devel_tips
> > [ 9] https://fedorahosted.org/sssd/wiki/pcech_test_reporting_sssd_bugs
> >
> > UPDATE:
> > [ 7] --> [ 1]
> > [ 8] --> [ 2]
> > [ 9] --> [ 4]
> > Pages [7,8,9] exist still, but we could remove it.
> > Pages [3,5,6] exist too, but I hope, no links target them. We could
> > remove it too.
> >
> > I am sorry, but after this ticket I am blind on wiki. Could somebody
> > check, that I did update properly? Thanks.
> >
> > Petr
>
> Hi,
>
> some time ago I edited wiki pages. The exact changes are described in
> the previous email.
> Today I erased the pages ([7,8,9] and [3,5,6]) that were marked for
> deletion. Its copies is attached.
>
> Regards
>
> Petr

Thanks for bumping this thread, I forgot to upload the new
coding guidelines, which I wanted to do after you do the
changes, but forgot to do so. I will do it ASAP.

Michal