Fixed various text section. Ready for review now.
This commit is contained in:
Peter Boy
parent
6fa39c96a8
commit
0d9001d261
8 changed files with 29 additions and 72 deletions
|
|
@ -5,6 +5,6 @@ version: rawhide
|
|||
prerelease: True
|
||||
nav:
|
||||
- modules/ROOT/nav.adoc
|
||||
- modules/release-notes/nav.adoc
|
||||
#- modules/release-notes/nav.adoc
|
||||
#- modules/install-guide/nav.adoc
|
||||
#- modules/system-administrators-guide/nav.adoc
|
||||
|
|
|
|||
|
|
@ -1,10 +1,8 @@
|
|||
* xref:index.adoc[starting page]
|
||||
* xref:index.adoc[Fedora User Documentation]
|
||||
** xref:getting-started.adoc[Getting started]
|
||||
*** xref:fedora-downloads-info.adoc[Fedora Downloads]
|
||||
*** xref:preparing-boot-media.adoc[Preparing Boot Media]
|
||||
*** xref:getting-help.adoc[Getting Help]
|
||||
** xref:system-upgrade.adoc[System upgrade]
|
||||
** Release Notes Fedora 35
|
||||
** Previous release notes
|
||||
** Fedora 37 Release Notes
|
||||
** Fedora 36 Release Notes
|
||||
** A newbee's primer
|
||||
|
|
|
|||
|
|
@ -1,10 +1,5 @@
|
|||
= Fedora Downloads
|
||||
|
||||
[IMPORTANT]
|
||||
====
|
||||
This is an *internal demo* and preview of the proposed changes to the Fedora user documentation. It is a *first draft* and part of a proof of concept. It is *neither valid information nor final content*. The intent is to outline the _structure_ of the documentation as a whole and the _intended message_ of this section.
|
||||
====
|
||||
|
||||
.Fedora Editions
|
||||
Fedora provides three primary Editions tailored for some specific use cases. link:++https://getfedora.org++[] offers Fedora Cloud for scalable infrastructure, Fedora Server for organizational infrastructure, and Fedora Workstation for the developer and desktop user.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,32 +0,0 @@
|
|||
= Getting help
|
||||
|
||||
[IMPORTANT]
|
||||
====
|
||||
This is an *internal demo* and preview of the proposed changes to the Fedora user documentation. It is a *first draft* and part of a proof of concept. It is *neither valid information nor final content*. The intent is to outline the _structure_ of the documentation as a whole and the _intended message_ of this section.
|
||||
====
|
||||
|
||||
This chapter offers some pointers on how to get help when something goes wrong. It also discusses some common installation problems and their solutions.
|
||||
|
||||
[[sect-troubleshooting-getting-help]]
|
||||
== Getting Help
|
||||
|
||||
There are many places on the internet which can help you when you encounter a problem not described in this chapter: discussion boards, blogs, IRC, and more. Some of the more popular places where you can find help include:
|
||||
|
||||
* link:++https://ask.fedoraproject.org/en/questions/++[Ask Fedora] - Fedora's knowledge base, available in multiple languages
|
||||
|
||||
* The #fedora IRC channel on link:++https://libera.chat/++[Libera.Chat] - one of the main IRC channels used by Fedora users, English only
|
||||
|
||||
* link:++https://fedoraproject.org/wiki/++[Fedora Project Wiki] - the official wiki for Fedora Project
|
||||
|
||||
* link:++https://unix.stackexchange.com/++[Stack Exchange] - an English language Q&A board, not specific to Fedora
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
|
||||
The above list is by no means complete - you can find help in many other places as well. Additional information about available resources such as IRC channels and mailing lists is available at link:++https://fedoraproject.org/wiki/Communicating_and_getting_help++[].
|
||||
|
||||
====
|
||||
|
||||
Before you open a new discussion or ask anyone for help on IRC, you should always do some research on your own. If you are encountering an issue, there is usually a good chance that someone else ran into the same problem before you and published a solution somewhere. Opening a discussion about something already explained elsewhere, or asking a common question which has been answered many times before, is not likely to result in a friendly, constructive response.
|
||||
|
||||
When you ask for help troubleshooting problems related to the installation, you may be asked to provide log files generated by the installer. The sections below explain which files are generated, what their contents are, and how to transfer them from the installation system.
|
||||
|
|
@ -1,10 +1,5 @@
|
|||
= Getting Started
|
||||
|
||||
[IMPORTANT]
|
||||
====
|
||||
This is an *internal demo* and preview of the proposed changes to the Fedora user documentation. It is a *first draft* and part of a proof of concept. It is *neither valid information nor final content*. The intent is to outline the _structure_ of the documentation as a whole and the _intended message_ of this section.
|
||||
====
|
||||
|
||||
[abstract]
|
||||
____
|
||||
This manual explains how to install Fedora on 64-bit AMD, Intel and Arm SystemReady machines. The guide and it's further detailed guides about different variants are intended for users of all levels of experience. However, it describes the installation process and its many options in far greater detail than most users are likely to require. This should help new users to complete the installation process without interruptions. Users my skip section about familiar topics.
|
||||
|
|
|
|||
|
|
@ -17,40 +17,45 @@ xref:getting-started.adoc[Getting started]::
|
|||
*First time with Fedory Linx?* New users find here extensiv information to get Fedora up and running
|
||||
xref:system-upgrade.adoc[System upgrade]::
|
||||
*You already have a Fedora Linux edtion or spin up and running?* You don't need to reinstall your system to get the new release. In fact, that's definitely not the recommended way. Fedora has put a lot of work into making an in-place update reliable and fully automated.
|
||||
Fedora 35 release notes::
|
||||
Fedora 37 release notes::
|
||||
Contains extensive information about new and modified features of the current release. Users are advised to skim this information to check, if the may affected by one of the changes or are now able to resolve an issue with a new feature
|
||||
Previous release notes::
|
||||
Fedora 36 Release Notes::
|
||||
Fedora supports the current und the previous release. As a reference here a quick link to the previous release notes.
|
||||
+
|
||||
In the top bar you can select older release notes. You can also access https://docs.fedoraproject.org/en-US/Fedora/26/html/Release_Notes/index.html[even older release notes]
|
||||
A newbee’s primer::
|
||||
Are you new to Linux? Here we provide some facts, vocabulary and links for a https://docs.fedoraproject.org/en-US/quick-docs/getting-started-guide/[first orientation].
|
||||
+
|
||||
[NOTE]
|
||||
====
|
||||
Editors note: TBD restructure / rename / relocate Quick Doc article
|
||||
====
|
||||
|
||||
|
||||
== Getting help
|
||||
[abstract]
|
||||
--
|
||||
* Link to ask.fp.o
|
||||
--
|
||||
There are many places on the internet which can help you when you encounter a problem not described in this chapter: discussion boards, blogs, IRC, and more. Some of the more popular places where you can find help include:
|
||||
|
||||
* link:++https://ask.fedoraproject.org/en/questions/++[Ask Fedora] - Fedora's knowledge base, available in multiple languages
|
||||
|
||||
* The #fedora IRC channel on link:++https://libera.chat/++[Libera.Chat] - one of the main IRC channels used by Fedora users, English only
|
||||
|
||||
* link:++https://fedoraproject.org/wiki/++[Fedora Project Wiki] - the official wiki for Fedora Project
|
||||
|
||||
* link:++https://unix.stackexchange.com/++[Stack Exchange] - an English language Q&A board, not specific to Fedora
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
|
||||
The above list is by no means complete - you can find help in many other places as well. Additional information about available resources such as IRC channels and mailing lists is available at link:++https://fedoraproject.org/wiki/Communicating_and_getting_help++[].
|
||||
|
||||
====
|
||||
|
||||
Before you open a new discussion or ask anyone for help on IRC, you should always do some research on your own. If you are encountering an issue, there is usually a good chance that someone else ran into the same problem before you and published a solution somewhere. Opening a discussion about something already explained elsewhere, or asking a common question which has been answered many times before, is not likely to result in a friendly, constructive response.
|
||||
|
||||
When you ask for help troubleshooting problems related to the installation, you may be asked to provide log files generated by the installer. The sections below explain which files are generated, what their contents are, and how to transfer them from the installation system.
|
||||
|
||||
== Join the community
|
||||
|
||||
[abstract]
|
||||
--
|
||||
* Link to discussion
|
||||
--
|
||||
Fedora has a vibrant community. The meeting place is the https://discussion.fedoraproject.org/tag/docs[Fedora Discussion] Forum.
|
||||
|
||||
|
||||
|
||||
== How to help us and give you back a better working Fedora
|
||||
[abstract]
|
||||
--
|
||||
* Provide feedback
|
||||
* Tell us about your usage
|
||||
--
|
||||
|
||||
The Fedora Documentation Project only actively maintains documentation for the most recent release and the one before it. We also preserve older documentation on this site for historical interest and to acknowledge the generous contribution of time and effort by many, many writers and translators.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,9 +1,5 @@
|
|||
= Upgrading Your Current System
|
||||
|
||||
[IMPORTANT]
|
||||
====
|
||||
This is an *internal demo* and preview of the proposed changes to the Fedora user documentation. It is a *first draft* and part of a proof of concept. It is *neither valid information nor final content*. The intent is to outline the _structure_ of the documentation as a whole and the _intended message_ of this section.
|
||||
====
|
||||
|
||||
This chapter explains how to upgrade your existing Fedora installation to the current release. There are two basic ways to do so:
|
||||
|
||||
|
|
|
|||
6
site.yml
6
site.yml
|
|
@ -11,9 +11,9 @@ content:
|
|||
#- url: https://gitlab.com/fedora/docs/fedora-linux-documentation/fedora-linux-sysadmin-guide.git
|
||||
# branches:
|
||||
# - main
|
||||
- url: https://pagure.io/fedora-docs/release-notes.git
|
||||
branches:
|
||||
- master
|
||||
#- url: https://pagure.io/fedora-docs/release-notes.git
|
||||
# branches:
|
||||
# - master
|
||||
ui:
|
||||
bundle:
|
||||
url: https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue