#3557 questions about documentation
Closed: Fixed 6 years ago Opened 6 years ago by sobek.

Before creating a PR I would like to have your opinion and need your input.

At:
https://docs.pagure.org/SSSD.sssd/users/faq.html#tracking-bugs-and-enhancement-requests
https://docs.pagure.org/SSSD.sssd/developers/contribute.html#tasks-for-newcomers
you can read about "Trac".
Is it OK to replace the word with "issue tracker"?

I found a contradiction in the documentation. At:
https://docs.pagure.org/SSSD.sssd/developers/contribute.html#source-code-repository
You can read:
"For the SSSD project, we use the Git source control system.
https://pagure.io/SSSD/sssd.git
We also maintain a read-only mirror on github."

However, at:
https://docs.pagure.org/SSSD.sssd/newcomers/getting_started.html#github-workflow
you can read:
"SSSD is hosted on pagure.io but the development happens on GitHub."

PRs are possible on pagure and GitHub.
Which stance should be fixed in which way?

Thank you for your help.


It can be confusing but it is not wrong.
I found a contradiction in the documentation. At:
https://docs.pagure.org/SSSD.sssd/developers/contribute.html#source-code-repository

You can read:
"For the SSSD project, we use the Git source control system.
https://pagure.io/SSSD/sssd.git
We also maintain a read-only mirror on github."

Referential git + issue tracker is on pagure. issues are disabled on github.
pagure git is mirrored to github

However, at:
https://docs.pagure.org/SSSD.sssd/newcomers/getting_started.html#github-workflow
you can read:
"SSSD is hosted on pagure.io but the development happens on GitHub."

Yes, most developers use pull requests on github. But we also merged, manually applied pull requests from pagure:
https://pagure.io/SSSD/sssd/pull-requests?status=0

At:
https://docs.pagure.org/SSSD.sssd/users/faq.html#tracking-bugs-and-enhancement-requests
https://docs.pagure.org/SSSD.sssd/developers/contribute.html#tasks-for-newcomers
you can read about "Trac".
Is it OK to replace the word with "issue tracker"?

it is a relict from wiki conversion to reStructuredText(rst).
Thank you very much for checking documetation.

you are welcome, thank you for your help :)

I propose to use:

Referential git + issue tracker is on pagure. issues are disabled on github.
pagure git is mirrored to github
and "use either pagure or GitHub for creating pull requests" as the main message.

In order to minimize the confusion I would like to put this information at:
https://docs.pagure.org/SSSD.sssd/developers/contribute.html#source-code-repository
and link to it at:
https://docs.pagure.org/SSSD.sssd/newcomers/getting_started.html#github-workflow
and reword to "Assuming you use GitHub these are the steps: ...".

I will wait some more days before starting the rewrite.

In the old wiki we also had https://gitlab.com/fidencio/sssd-docs-backup/blob/master/GithubWorkflow.rst

If you are planning to contribute to our documentation, that would be really awesome, but would you consider also merging the information from the old wiki?

I will merge the information.

Since the docs PR had been closed, I'm also closing this ticket.

Metadata Update from @jhrozek:
- Issue close_status updated to: Fixed
- Issue status updated to: Closed (was: Open)

6 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/4582

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