Infrastructure/infra-docs-fpo
3
0
Fork 0
Code Issues 100 Pull requests 6 Projects Releases Packages Wiki Activity Actions

communishift user documentation needs improvement for first-timers #301

New issue
Open
opened 2024-06-24 14:53:21 +00:00 by moralcode · 2 comments
moralcode commented 2024-06-24 14:53:21 +00:00
Contributor
Copy link

My communishift ticket (https://pagure.io/fedora-infrastructure/issue/11970) recently got okayed and i got added to a FAS group. But i couldnt find where to log in.

Things tried:

Id like to help improve the user docs for communishift (especially since the recent relaunch) but im not sure when ill get to that. i have a lot of other changes i want to make to the docs.fp.o site in general too so i wanted to file this issue so i can keep track of it

Feel free to add comments to this ticket if theres other things youd like to see added to the communishift user docs (especially since it looks like there may be some kind of hackfest at Flock)

My communishift ticket (https://pagure.io/fedora-infrastructure/issue/11970) recently got okayed and i got added to a FAS group. But i couldnt find where to log in. Things tried: - The user docs (the ones im filing this issue against) which are linked to from https://communityblog.fedoraproject.org/communishift-now-available/ (https://docs.fedoraproject.org/en-US/infra/communishift/) didnt mention it - the openshift docs from the slides at the devconf talk (https://docs.openshift.com/dedicated/web_console/web-console.html) direct me to https://console.redhat.com/openshift which seems to want red hat credentials, not FAS so that seems wrong - the [wiki](https://fedoraproject.org/wiki/Infrastructure/Communishift) links to https://console-openshift-console.apps.os.fedorainfracloud.org/ which doesnt load (anything i can do to help clean up the old stuff on the wiki?) - https://docs.fedoraproject.org/en-US/infra/developer_guide/openshift/#_openshift links to some openshift links but i learned those are for staging and prod, which are different - after sending out several messages to the infra chat and the CPE folks, i learned the correct link is https://console-openshift-console.apps.fedora.cj14.p1.openshiftapps.com/ Id like to help improve the user docs for communishift (especially since the recent relaunch) but im not sure when ill get to that. i have a lot of other changes i want to make to the docs.fp.o site in general too so i wanted to file this issue so i can keep track of it Feel free to add comments to this ticket if theres other things youd like to see added to the communishift user docs (especially since it looks like there may be some kind of [hackfest at Flock](https://discussion.fedoraproject.org/t/planning-for-infra-and-releng-hackfest-at-flock-2024/110244/9))
smilner commented 2024-06-25 15:56:47 +00:00
Copy link

Thank you @moralcode!! cc @patrikp @pbokoc

Thank you @moralcode!! cc @patrikp @pbokoc
zlopez commented 2024-06-28 07:09:41 +00:00
Contributor
Copy link

That would be good to ask people on Flock, what is missing in user docs for communishift. We already have few tenants that could have some idea what is missing.

That would be good to ask people on Flock, what is missing in user docs for communishift. We already have few tenants that could have some idea what is missing.
rcallwoo added this to the Unified backlog project 2025-08-07 01:51:54 +00:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
master
No results found.
Labels
Clear labels   
rerwite-required

   
SOP

   
untriaged
  
blocked

Indicates the work cannot proceed. There is a dependency or an issue that is preventing the team from completing the task. This is a flag for the Scrum Master to help unblock the team.

  
Bug

The software is not behaving as expected. It could be an error, a crash, or an incorrect result. Bugs often need to be prioritized based on their severity and business impact

  
Chore

Tasks that are necessary but don't directly deliver new value to the end-user. These are internal tasks like updating a library, managing user accounts, or setting up a new service.

  
Feature

It's something that a user would be able to see or interact with, such as a new button, a new page, or an improved workflow.

  
in-progress

This label is for work that a developer is actively working on. This is usually what you'll see on the "In Progress" column of your project board.

  
points:1

A task that is simple, small, and has very little uncertainty. It should be easy enough for any team member to pick up and complete quickly, without a lot of discussion or research.

  
points:13

Any task that feels like it's a "13" or more is considered an Epic. These are too large and uncertain to be worked on in a single sprint.

  
points:2

This is a task that is slightly more complex or larger than a "1." It might involve two or three simple steps, but the outcome is still very clear and there's little uncertainty.

  
points:3

medium-sized task with some noticeable complexity. It might require a bit more thought or collaboration. The steps are well-defined, but it's not a trivial change.

  
points:5

a significant piece of work. It has more complexity and a higher degree of uncertainty than smaller tasks. It might require some research, a design discussion, or collaboration across multiple teams.

  
points:8

complex task with a lot of uncertainty. It's often the largest size that a team will consider for a single sprint. It likely requires a detailed breakdown and multiple team members to complete.

  
priority:high

This is for work that is critical and needs to be addressed in the next sprint. It's often for urgent bugs, important features, or a major piece of technical debt that is blocking other work.

  
priority:low

This is for work that is good to do but not urgent. It's a candidate for being worked on when there's extra time or when it rises in importance. It can stay in the backlog for a longer period.

  
priority:medium

This is for important work that should be done soon, but isn't as urgent as a high-priority item. It will likely be considered for the next 1-2 sprints.

  
ready

indicates that an issue has been fully refined, has a story point value, and is ready to be pulled into a sprint. It has all the information needed for a developer to start working on it immediately.

  
review

This indicates that the work is complete, but it is now in a review state. This could mean a peer code review, a QA check, or a review by the Product Owner.

  
Technical Debt

work that improves the codebase without adding new features. It's work that pays down the "debt" you've accumulated, such as refactoring a messy piece of code, improving test coverage.

No labels
rerwite-required
SOP
untriaged
blocked
Bug
Chore
Feature
in-progress
points:1
points:13
points:2
points:3
points:5
points:8
priority:high
priority:low
priority:medium
ready
review
Technical Debt
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Unified backlog
Assignees
Clear assignees
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Infrastructure/infra-docs-fpo#301
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?