Review of older documents: Finding and installing Linux applications #521
Labels
No labels
bug
Closed As
complete
Closed As
duplicate
Closed As
insufficient data
Closed As
moved
Closed As
not possible
Closed As
out of scope
Closed As
stale
good first issue
help wanted
improvement
needs changes
needs committer review
needs info
new change
Priority
awaiting triage
Priority
needs review
Priority
next meeting
Priority
waiting on assignee
Priority
waiting on external
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference: Docs/quick-docs#521
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
We decided to start a Review of older Quick Docs articles:
URL: https://docs.fedoraproject.org/en-US/quick-docs/finding-and-installing-linux-applications/
Metadata Update from @hankuoffroad:
Metadata Update from @hankuoffroad:
Could you advise how I can refer to the documents in the link (import attributes) below? I want to reuse some of text in source docs without copy and paste.
include::{partialsdir}/con_package-management-in-fedora.adoc[leveloffset=+1]
include::{partialsdir}/proc_package-searching-web-apps.adoc[leveloffset=+1]
include::{partialsdir}/proc_package-browsing-installing-software.adoc[leveloffset=+1]
include::{partialsdir}/proc_package-install-command-line.adoc[leveloffset=+1]
include::{partialsdir}/proc_package-enabling-third-party.adoc[leveloffset=+1]
ifdef::parent-context[:context: {parent-context}]
ifndef::parent-context[:!context:]
Let's discuss that on our meeting 2022-12-14.
I'm considering: Is it useful for (short) how-to's to use partials?
I just noticed: there is an quite old issue about this article:
https://pagure.io/fedora-docs/quick-docs/issue/105
It suggest to remove it because there is too much to modify. Not sure about that.
Metadata Update from @pboy:
I'm working on rewriting the entire page.
I did look through sub pages under 'adding and managing software', and what we need on the heading 'Finding and installing Linux applications' is how to browse software by which categories and which tools.
I'm considering to rewrite it altogether because most of content on the partials are irrelevant now.
Edited:
Here is the ToC for revised 'Finding and installing Linux applications'.
https://packages.fedoraproject.org/
I think the partials are important for content reuse, which is a potential topic for a short how to guide.
I'm still learning it, so someone who is proficient with the partials could pick it up for writing.
The process diverges depending on desktop environment, so it takes time.
I have done testing and writing up for dnfdragora in Xfce and LXQt.
I'm on KDE. Aim to finish a draft by 14 Jan.
A draft is ready before PR. The process will diverge depending on GNOME and KDE. I will skip dnfdragora because it is not working out of box in Xfce.
Once I know how to insert images, I'll do PR. 14/01/23
@pboy the updated draft and images sent to your Fedora email address for review and PR.
With the new version, we have now a leftover of probably unused partials:
We should git rid of them. Even if they are used elsewhere, they are outdated. And in general, I think, Quick docs shouldn't use and offer partials for reuse.
In a first step, we can rename these partials, e.g. by adding ".deleteme", and see where something breaks.
ok I agree with archiving and phasing out partials. It is just not on my tool belt. Can we discuss on the Docs meeting and move forward? I wonder if there are better ways to reuse content from Wiki.
Following feedback from @pboy and Discussion, I have written a synopsis before I proceed with rewriting the docs related to #521
Any comments, please leave them here for me to revise and resubmit. After we reach a consensus among a few contributors, I'll start writing a draft.
To view the source file below, click it to open with your default editor or web browser.
Thanks
Metadata Update from @hankuoffroad:
Updated synopsis for your review and comments.
Extra sections I recommend are extra libraries and development tools in EPEL and crb with RHEL.
Will take a few days to test drive EPEL and crb.
@ankursinha could you advise where to put image paths?
inside [] or just before the file name?
image::../images/GNOME1_featured.png[]
Can anyone help fixing image links with the image attached? I'll revise the #521 when agreed with @pboy and a few more contributors. Hard to get round to Pagure git workflow. Thanks.
The images would go into:
~/modules/ROOT/assets/images/<ARTICLENAME_SHORTEND>/.png
If you retain the original title it could be a subdir of
finding-installing-linux-apps
(and the article name finding-installing-linus-apps.adoc
and the title Finding and installing Linux applications )
i.e.
~/modules/ROOT/assets/images/finding-installing-linux-apps/.png
You would refer to the image in the text as:
image::finding-installing-linux-apps/IMAGE-01.png
That way we would follow a distinct naming convention.
Sent it to you via email. I seem to be too dumb to finde a way to upload an *.adoc file
A new PR due to merge conflict before.
Could anyone help with revising text?
https://pagure.io/fedora-docs/quick-docs/pull-request/566
@pboy, Thanks for looking into image macro I had hard time to get it right. I followed your suggestions. However, I couldn't get the image rendered. Merged for incremental update and fix.
Here's the output, in the meantime.
https://docs.fedoraproject.org/en-US/quick-docs/finding-and-installing-linux-applications/
Image macro to be added at the end. Image rendered correctly in local preview.
image::finding-installing-linux-apps/gnome1-featured.png[]
PR merged. Closing this issue.
Metadata Update from @hankuoffroad: