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
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 repoand * 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".
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 killedwith … 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 sssd-devel@lists.fedorahosted.org https://lists.fedorahosted.org/mailman/listinfo/sssd-devel
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 repoand * 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 TriageHmm, 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 RepositoriesWe 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 InternationalizationThis 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 PagesI 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...
CreditsTo 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 PresentationsI 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".
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 killedwith … 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 TipsThese 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 sssd-devel@lists.fedorahosted.org https://lists.fedorahosted.org/mailman/listinfo/sssd-devel
sssd-devel mailing list sssd-devel@lists.fedorahosted.org 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
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
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
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)
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
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.
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 sssd-devel@lists.fedorahosted.org https://lists.fedorahosted.org/mailman/listinfo/sssd-devel
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
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
sssd-devel@lists.fedorahosted.org
-
Jakub Hrozek -
Michal Židek -
Petr Cech