Initial content of the Package Maintainer Docs was imported from various wiki pages. After Package Maintainer Docs have been published, replace the old wiki pages with links pointing to the new docs. There have been some updates to the wiki in between, so check for them and import them to the Docs also.
I added an asciidoc comment at the top of each docs page identifying the wiki source page:
// Imported from: https://fedoraproject.org/wiki/Package_maintenance_guide
Unfortunately, date of import for each page is not available because I did not log it appropriately when the conversion was made. I started conversion on 2021-05-05, so that this the earliest possible import date for each page.
So far I have identified the following imports: https://github.com/iagorubio/fedora-docs/blob/main/issue20/package-maintainer-imports.txt
The command used to extract them is:
find . -type f -name "*.adoc" | xargs grep Imported > ../package-maintainer-imports.txt
If someone finds something is missing please post it here.
Thanks.
Metadata Update from @oturpe: - Issue assigned to iago
Are we going to use redirects so that the wiki pages remain but get automatically redirected to the new docs pages?
https://docs.fedoraproject.org/en-US/quick-docs/contribute-to-quick-docs/#_wiki_redirects
Are we going to use redirects so that the wiki pages remain but get automatically redirected to the new docs pages? https://docs.fedoraproject.org/en-US/quick-docs/contribute-to-quick-docs/#_wiki_redirects
When I wrote this issue, I was thinking of how Wiki page Packaging:Guidelines does it, i.e. the only Wiki page content being a note about the move and a link to the new location. Thank you for pointing out the Wiki redirect plugin — I think I have seen that in action once, though I did not know how it was implemented. Both options do basically the same, the main difference seems to be if the focus is put on making it clear that links to the old location are stale or in taking the user to the correct location with minimum disturbance. I am indifferent to which one is used here.
Yeh, whatever is easiest. As you note, the redirect means folks don't need to do anything since they get redirected. The only advantage I can see of the redirects is that crawlers for search engines may also get redirected which will make search results better (not sure if this is the case, though).
Being a server side redirect - 301 Moved Permanently - the new page gets indexed by most robots.
A client side redirect - document.location.href = "new.url - is the former page what gets indexed, so in this case, wiki redirects may help to get the new content on search engines.
One way or the other, as the old wiki page is indexed, a link there to the new doc will also work to get the robots to index them.
I commited fix for the following pages and replaced the wiki pages with links. Pages are marked done by removing the // Imported from: line from the top of the page. Remaining work can be found by grepping for that string.
// Imported from:
I used the visible link method. I do not understand much about search engine optimization, so it that was actually a bad choice, we can change the links to automatic redirects if that is the better options.
https://fedoraproject.org/wiki/How_to_get_sponsored_into_the_packager_group https://fedoraproject.org/wiki/How_to_sponsor_a_new_contributor https://fedoraproject.org/wiki/Package_maintenance_guide https://fedoraproject.org/wiki/Orphaned_package_that_need_new_maintainers https://fedoraproject.org/wiki/Package_Renaming_Process https://fedoraproject.org/wiki/How_to_remove_a_package_at_end_of_life https://fedoraproject.org/wiki/Package_Review_Process https://fedoraproject.org/wiki/Package_update_HOWTO https://fedoraproject.org/wiki/Staying_close_to_upstream_projects
The remaining pages are fixed in commit d0e1bca
Metadata Update from @oturpe: - Issue status updated to: Closed (was: Open)
Login to comment on this ticket.