As I hope everyone knows, the plan is to change the Fedora wiki from being a mix of user and contributor documentation and workspace into *just* being active workspace. But, we have a number of very popular pages which are pure documentation. We should migrate these. Here is the top list (leaving off things like EPEL and Join), in order for page views in 2017 to date:
1. http://fedoraproject.org/wiki/How_to_create_and_use_Live_USB 2. http://fedoraproject.org/wiki/DNF_system_upgrade 3. http://fedoraproject.org/wiki/Windows_Virtio_Drivers 4. http://fedoraproject.org/wiki/How_to_edit_iptables_rules 5. http://fedoraproject.org/wiki/GRUB_2 6. http://fedoraproject.org/wiki/How_to_create_an_RPM_package 7. http://fedoraproject.org/wiki/SysVinit_to_Systemd_Cheatsheet 8. http://fedoraproject.org/wiki/Firewalld 9. http://fedoraproject.org/wiki/Upgrading_Fedora_using_package_manager 10. https://fedoraproject.org/wiki/Architectures/ARM/Raspberry_Pi
It'd be awesome to set some team goals around getting these migrated. Maybe even a VFAD?
On Tue, Oct 24, 2017 at 11:56:44AM -0400, Matthew Miller wrote:
- http://fedoraproject.org/wiki/How_to_create_and_use_Live_USB
- http://fedoraproject.org/wiki/DNF_system_upgrade
- http://fedoraproject.org/wiki/Windows_Virtio_Drivers
- http://fedoraproject.org/wiki/How_to_edit_iptables_rules
- http://fedoraproject.org/wiki/GRUB_2
- http://fedoraproject.org/wiki/How_to_create_an_RPM_package
- http://fedoraproject.org/wiki/SysVinit_to_Systemd_Cheatsheet
- http://fedoraproject.org/wiki/Firewalld
- http://fedoraproject.org/wiki/Upgrading_Fedora_using_package_manager
- https://fedoraproject.org/wiki/Architectures/ARM/Raspberry_Pi
Here's the next 40, by the way, in case anyone is feeling ambitious. :)
11. https://fedoraproject.org/wiki/Systemd 12. https://fedoraproject.org/wiki/PackageKit_Items_Not_Found 13. https://fedoraproject.org/wiki/DNF 14. https://fedoraproject.org/wiki/Bumblebee 15. https://fedoraproject.org/wiki/Repositories 16. https://fedoraproject.org/wiki/FedoraLiveCD 17. https://fedoraproject.org/wiki/Switching_Desktop_Environments 18. https://fedoraproject.org/wiki/Networking/CLI 19. https://fedoraproject.org/wiki/Upgrading 20. https://fedoraproject.org/wiki/Getting_started_with_virtualization
21. https://fedoraproject.org/wiki/How_to_reset_a_root_password 22. https://fedoraproject.org/wiki/Configuring_Sudo 23. https://fedoraproject.org/wiki/Chromium 24. https://fedoraproject.org/wiki/Creating_GPG_Keys 25. https://fedoraproject.org/wiki/Anaconda 26. https://fedoraproject.org/wiki/PostgreSQL 27. https://fedoraproject.org/wiki/How_to_debug_Wayland_problems 28. https://fedoraproject.org/wiki/How_to_debug_Dracut_problems 29. https://fedoraproject.org/wiki/Building_a_custom_kernel 30. https://fedoraproject.org/wiki/Using_UEFI_with_QEMU
31. https://fedoraproject.org/wiki/How_to_debug_Systemd_problems 32. https://fedoraproject.org/wiki/Spotify 33. https://fedoraproject.org/wiki/How_to_enable_nested_virtualization_in_KVM 34. https://fedoraproject.org/wiki/JDK_on_Fedora 35. https://fedoraproject.org/wiki/How_to_use_qemu 36. https://fedoraproject.org/wiki/Spotify 37. https://fedoraproject.org/wiki/Third_party_repositories 38. https://fedoraproject.org/wiki/Package_management_system 39. https://fedoraproject.org/wiki/How_to_enable_touchpad_click 40. https://fedoraproject.org/wiki/Apache_HTTP_Server
41. https://fedoraproject.org/wiki/Java 42. https://fedoraproject.org/wiki/Infrastructure/Mirroring 43. https://fedoraproject.org/wiki/Fedora_Release_Life_Cycle 44. https://fedoraproject.org/wiki/Flash 45. https://fedoraproject.org/wiki/Kernel 46. https://fedoraproject.org/wiki/Wine 47. https://fedoraproject.org/wiki/How_to_create_and_use_a_Live_CD 48. https://fedoraproject.org/wiki/Red_Hat_Enterprise_Linux 49. https://fedoraproject.org/wiki/OpenH264 50. https://fedoraproject.org/wiki/AutoUpdates
Well, I can take the hit of being wiki mantainer, and I would like to move all these pages to a /docs section in the wiki (I don't think we shouldn't delete these from the wiki until the docs are totally established). What do you think about it?
Br,
2017-10-24 13:04 GMT-03:00 Matthew Miller mattdm@fedoraproject.org:
On Tue, Oct 24, 2017 at 11:56:44AM -0400, Matthew Miller wrote:
- http://fedoraproject.org/wiki/How_to_create_and_use_Live_USB
- http://fedoraproject.org/wiki/DNF_system_upgrade
- http://fedoraproject.org/wiki/Windows_Virtio_Drivers
- http://fedoraproject.org/wiki/How_to_edit_iptables_rules
- http://fedoraproject.org/wiki/GRUB_2
- http://fedoraproject.org/wiki/How_to_create_an_RPM_package
- http://fedoraproject.org/wiki/SysVinit_to_Systemd_Cheatsheet
- http://fedoraproject.org/wiki/Firewalld
- http://fedoraproject.org/wiki/Upgrading_Fedora_using_package_manager
- https://fedoraproject.org/wiki/Architectures/ARM/Raspberry_Pi
Here's the next 40, by the way, in case anyone is feeling ambitious. :)
https://fedoraproject.org/wiki/Switching_Desktop_Environments
https://fedoraproject.org/wiki/Getting_started_with_virtualization
https://fedoraproject.org/wiki/How_to_debug_Wayland_problems
https://fedoraproject.org/wiki/How_to_debug_Systemd_problems
virtualization_in_KVM 34. https://fedoraproject.org/wiki/JDK_on_Fedora 35. https://fedoraproject.org/wiki/How_to_use_qemu 36. https://fedoraproject.org/wiki/Spotify 37. https://fedoraproject.org/wiki/Third_party_repositories 38. https://fedoraproject.org/wiki/Package_management_system 39. https://fedoraproject.org/wiki/How_to_enable_touchpad_click 40. https://fedoraproject.org/wiki/Apache_HTTP_Server
- https://fedoraproject.org/wiki/Java
- https://fedoraproject.org/wiki/Infrastructure/Mirroring
- https://fedoraproject.org/wiki/Fedora_Release_Life_Cycle
- https://fedoraproject.org/wiki/Flash
- https://fedoraproject.org/wiki/Kernel
- https://fedoraproject.org/wiki/Wine
- https://fedoraproject.org/wiki/How_to_create_and_use_a_Live_CD
- https://fedoraproject.org/wiki/Red_Hat_Enterprise_Linux
- https://fedoraproject.org/wiki/OpenH264
- https://fedoraproject.org/wiki/AutoUpdates
-- Matthew Miller mattdm@fedoraproject.org Fedora Project Leader _______________________________________________ docs mailing list -- docs@lists.fedoraproject.org To unsubscribe send an email to docs-leave@lists.fedoraproject.org
On Tue, Oct 24, 2017 at 01:14:29PM -0300, Eduard Lucena wrote:
Well, I can take the hit of being wiki mantainer, and I would like to move all these pages to a /docs section in the wiki (I don't think we shouldn't delete these from the wiki until the docs are totally established). What do you think about it?
I agree that we shouldn't delete them; I think that would be bad for search results. Unfortunately, we can't do redirects from the wiki to the docs site (that would be a security nightmare). Instead, I think we should add this to the top of each page once it is edited:
{{admon/note|This page has a new home!| This wiki page is no longer maintained. Please find the up-to-date version at: https://docs.fedoraproject.org/whatever-the-url }}
For pages which are really out of date, also add
{{old}}
... and in fact maybe should add that to all of them. Then, we can bulk-move all of those pages to Archive at some point and get them out of the way.
On Tue, Oct 24, 2017 at 12:04:38PM -0400, Matthew Miller wrote:
Here's the next 40, by the way, in case anyone is feeling ambitious. :)
Another note: these are almost entirely sysadmin guide topics. One approach would be to make sure that each of these topics is well-covered in the migrated sysadmin guide, which we have at https://docs.stg.fedoraproject.org/f26/system-administrators-guide/index.htm...
However, I'm worried that "sysadmin guide" is a scary section title for non-sysadmins.
What if we start a new section called "Fedora HOWTO Guides" or similar, and dump these all into that? We can come up with some kind of further structure as content accumulates.
On 10/24/2017 11:56 AM, Matthew Miller wrote:
As I hope everyone knows, the plan is to change the Fedora wiki from being a mix of user and contributor documentation and workspace into *just* being active workspace. But, we have a number of very popular pages which are pure documentation. We should migrate these. Here is the top list (leaving off things like EPEL and Join), in order for page views in 2017 to date:
- http://fedoraproject.org/wiki/How_to_create_and_use_Live_USB
- http://fedoraproject.org/wiki/DNF_system_upgrade
- http://fedoraproject.org/wiki/Windows_Virtio_Drivers
- http://fedoraproject.org/wiki/How_to_edit_iptables_rules
- http://fedoraproject.org/wiki/GRUB_2
- http://fedoraproject.org/wiki/How_to_create_an_RPM_package
- http://fedoraproject.org/wiki/SysVinit_to_Systemd_Cheatsheet
- http://fedoraproject.org/wiki/Firewalld
- http://fedoraproject.org/wiki/Upgrading_Fedora_using_package_manager
- https://fedoraproject.org/wiki/Architectures/ARM/Raspberry_Pi
It'd be awesome to set some team goals around getting these migrated. Maybe even a VFAD?
Hi all,
It would be helpful to communicate these changes out to build awareness and attract new contributors. I want to help contribute time to move community wiki pages to docs and help build awareness for this migration (but need help to do this).
I am new to this list, but after Flock this year, the CommOps team has a strong interest in helping with this too, at the community docs level. Since my time is focusing down on specific tasks in Fedora, this is something I want to help support the team with (so a small team of busy people aren't migrating eons of wiki docs).
By early November, I want to do a post or first part of a mini-series on the Community Blog to help explain **why** these changes are important and why we need help from others to do it. I assume the comment about most people knowing of the planned migration is aimed at the docs team, not the wider community. I want to help build that awareness outside of this team too – not just that it's happening, but why it's happening.
Are there any written updates / blog posts by any team members of the work over the last few months? This will be a good reference for me since I'm jumping in late.
Also, are there any "recommended reads" on writing AsciiDoc with a Fedora spin on it? I got a taste of it at Flock, but it would be helpful to know if there's a "recommended read" on AsciiDoc by the Docs team, if it isn't only the upstream documentation.
This is exciting to me, and this week at All Things Open¹, the importance of documentation is a common theme for building better projects. I hope to be of help to this, maybe less with actually migrating docs, but helping enable others to write docs too.
Thanks!
On Tue, Oct 24, 2017 at 04:57:00PM +0000, Justin W. Flory wrote:
It would be helpful to communicate these changes out to build awareness and attract new contributors. I want to help contribute time to move community wiki pages to docs and help build awareness for this migration (but need help to do this).
Yeah. There's some degree of chicken-and-egg -- we need to have the infrastructure in place and some good examples. I was thinking a comm blog post would be a good idea, but hadn't gone much past that thought. :)
By early November, I want to do a post or first part of a mini-series on the Community Blog to help explain **why** these changes are important and why we need help from others to do it. I assume the comment about most people knowing of the planned migration is aimed at the docs team, not the wider community. I want to help build that awareness outside of this team too – not just that it's happening, but why it's happening.
+1 -- yes, awesome.
(I'll leave the rest to someone actually directly involved with Docs.)
On Tue, Oct 24, 2017 at 11:56:44AM -0400, Matthew Miller wrote:
As I hope everyone knows, the plan is to change the Fedora wiki from being a mix of user and contributor documentation and workspace into *just* being active workspace. But, we have a number of very popular pages which are pure documentation. We should migrate these. Here is the top list (leaving off things like EPEL and Join), in order for page views in 2017 to date:
Okay, so, while I was travelling a got inspired and did a rough conversion for all of the top 50 to
https://pagure.io/fedora-docs/quick-docs
via pandoc and some hacky scripting. I propose we get this stuff online under https://docs.fedoraproject.org/other-releases.html (next to the beta documentation). Then, it'll be easy work to clean up each document one at a time.
docs@lists.stg.fedoraproject.org
-
Eduard Lucena -
Justin W. Flory -
Matthew Miller