Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

CONTRIBUTING.md ToC out of date #90

Open
6 tasks
fyliu opened this issue Sep 12, 2024 · 1 comment · May be fixed by #91
Open
6 tasks

CONTRIBUTING.md ToC out of date #90

fyliu opened this issue Sep 12, 2024 · 1 comment · May be fixed by #91

Comments

@fyliu
Copy link
Member

fyliu commented Sep 12, 2024

Overview

As an active project, we need to keep the onboarding documentation updated so that newcomers have an easier time getting through the initial tasks. For this issue, we need to update the CONTRIBUTING.md table of contents, or remove it and tell people to use the GitHub auto-generated outline instead.

Action Items

  • [Option 1] Remove the ToC and use the auto-outline
    • Remove the ToC
    • Add instruction on how to toggle the outline
  • [Option 2] Update the ToC
    • Fix indents
    • Fix the order of items
    • Add missing item
    • Fix bad link and verify other links

Resources/Instructions

The image shows several things:

  1. There's a button in the upper-right to toggle the auto-outline, which is the column to the right.
  2. The manually-maintained ToC in the document now contains some errors:
    1. Some items should have reduced indentation (see short arrowed lines on the left)
    2. A couple items have swapped positions (see dotted line)
    3. One link is bad (see double arrow dashed line)
    4. One item is missing (see dotted single arrow line)

image

@here
Copy link
Member

here commented Nov 25, 2024

@here here transferred this issue from hackforla/ops Nov 25, 2024
here added a commit that referenced this issue Nov 25, 2024
here added a commit that referenced this issue Nov 25, 2024
@here here linked a pull request Nov 25, 2024 that will close this issue
@ale210 ale210 moved this from Questions/Review to In progress (actively working) in CoP: DevOps: Project Board Nov 28, 2024
@ale210 ale210 added this to the 05 team workflow milestone Nov 28, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: In progress (actively working)
Development

Successfully merging a pull request may close this issue.

6 participants