#2951 Build instructions link to missing page
Closed: Fixed None Opened 8 years ago by matsimon.

For at least SSSD 1.12.5 and 1.13.3 the included BUILD.txt links to

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

Which does not exist in wiki, that hurts the experience if the documentation is absent.

It seems the page was deleted in a wiki cleanup, however if the source says a documentation should be found under a certain URL, it should at least redirect to a currently valid page. (Reference: https://lists.fedorahosted.org/archives/list/sssd-devel@lists.fedorahosted.org/message/JRMO6JBKDPVP63ZJGWBDF6Y3A5BZFWSA/)

Which one should it be?

Regards,
Mathieu


We have https://fedorahosted.org/sssd/wiki/Contribute and https://fedorahosted.org/sssd/wiki/DevRes are those not sufficient or hard to find?

btw you can ask questions like this on the devel list, maybe it would be even better so that others can find them later in the archives.

Hi Jakub

I saw them (trac is indexed by search machines too) however:

- Typically one gets the source tarball or a git checkout
- Looks for the README file and gets pointed to BUILD.txt
- Currently BUILD.txt contains a link which goes to a nonexistent page.

Conclusion: The chain to get the to right information is broken at this point.
I hope that doesn't sound too picky, but I hope you see the issue. :-)

Therefore could:

  • I add /DevelTutorials back by simply adding i.e.

    The content of this page has been replaced, up-to-date instruction can be found in [[Contribute]]

  • maybe someone of the developers apply the following micro-patch to the master branch:

    --- BUILD.txt.orig 2016-02-08 12:45:41.768000000 +0100
    +++ BUILD.txt 2016-02-08 12:45:50.024000000 +0100
    @@ -2,6 +2,6 @@
    project can be found here:
    ~~

    -https://fedorahosted.org/sssd/wiki/DevelTutorials
    +https://fedorahosted.org/sssd/wiki/Contribute

    ~~

This would fix the path to the instructions for future and upcoming release.
Is that something?

Regards, Mathieu

Yes, you're right we should add a simple stub to the old page pointing to the new. Thanks for pointing that out, I added some links to the new pages.

At least here the BUILD.txt includes:

The instructions on how to build the SSSD and contribute to the
project can be found here:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

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

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Thank you, all things fixed :-)
I don't have the rights to close the ticket myself, so feel free.

-- Mathieu

Fields changed

resolution: => fixed
status: new => closed

Fields changed

rhbz: => 0

Metadata Update from @matsimon:
- Issue set to the milestone: NEEDS_TRIAGE

7 years ago

SSSD is moving from Pagure to Github. This means that new issues and pull requests
will be accepted only in SSSD's github repository.

This issue has been cloned to Github and is available here:
- https://github.com/SSSD/sssd/issues/3992

If you want to receive further updates on the issue, please navigate to the github issue
and click on subscribe button.

Thank you for understanding. We apologize for all inconvenience.

Login to comment on this ticket.

Metadata