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

Difficult Navigation #645

Open
silabs-robin opened this issue Jan 8, 2024 · 5 comments
Open

Difficult Navigation #645

silabs-robin opened this issue Jan 8, 2024 · 5 comments
Assignees

Comments

@silabs-robin
Copy link
Contributor

Type

Indicate whether the type of problem you found:

  • Confusing or poorly worded information.

Location of Issue

https://github.com/openhwgroup/programs

Additional context

I was looking for the 40p signoff checklist, and the signoff checklist template, etc, but it was very difficult to locate (even when I knew approximately what I was looking for).
In general, I don't understand this repo, neither the top-level directories nor any sub-level.
The result (I think) is that this repo often gets ignored or avoided.
I am posting this not to vent or to complain, but because I think it could be useful for the openhwgroup to be aware of the problem (and if deemed beneficial, also change it).

See also:

@MikeOpenHWGroup
Copy link
Member

Thanks for the feedback @silabs-robin. This repository has multiple uses and obviously does not serve those who are interested in sign-off checklists. Part of the reason for that is that there is only one example of a completed TRL-5 sign-off.

Question for you and @DBees: would it make sense to move the signoff material to its own top-level directory? So rather than programs/Project-Descriptions-and-Plans/CV32E40Pv1/Milestone-data, we would have programs/Milestone-Signoff/CV32E40Pv1.

In this way, anything related to Project descriptions, etc. would stay in it's own top-level directory and anything related to Signoff would be in a separate top-level directory.

@DBees
Copy link
Contributor

DBees commented Jan 10, 2024

That's ok for me @MikeOpenHWGroup @silabs-robin . I can see why it is felt to be buried. I'll move the data via pull request.

@MikeOpenHWGroup
Copy link
Member

Thanks @DBees. Let's leave this Issue open until your PR happens.

@silabs-robin
Copy link
Contributor Author

silabs-robin commented Jan 15, 2024

I can show you how I read the top-level:

  • Project-Descriptions-and-Plans
    • "Some administrative openhw stuff, not relevant for me"
  • TGs
    • "Some administrative openhw stuff, not relevant for me"
  • TWG-and-TG-Attendance-Tracking
    • "Meeting attendance tracking, not relevant for me"
  • TWG
    • "Some administrative openhw stuff, not relevant for me"
  • dashboard
    • "Maybe we have some CI/CD dashboard and this is a user guide, or maybe its an overview of openhw project status"
  • docs
    • "Maybe shows newbeginners what openhw is and gives an overview of projects and repos"
  • process
    • "Here I might find "sign-off checklists", because that is a standardized process."
  • program
    • "Some administrative openhw stuff, not relevant for me"

@DBees
Copy link
Contributor

DBees commented Jan 15, 2024

@silabs-robin Thanks a lot for the feedback on the content here. I'm delighted to have any suggestions you make and consider how to make this repo more helpful to you and other participants.

Your points:

Project-Descriptions-and-Plans
"Some administrative openhw stuff, not relevant for me"

This is a set of of directories, each of which corresponds to an OpenHW project. For each project, we have the Project Concept (the initial project idea and motivation to take the project on) and subsequent project gates. OpenHW is member-driven, and the members decide which projects to accept. They also assess projects' progress leading up to release.
As member of OpenHW, I hope this is relevant for you. Can you consider attending the TWG meetings (held on the 4th Tuesday of each month) to participate in this?

TGs
"Some administrative openhw stuff, not relevant for me"

The intent here is to provide a place for monthly project reports, organized by TG.

TWG-and-TG-Attendance-Tracking
"Meeting attendance tracking, not relevant for me"

TWG
"Some administrative openhw stuff, not relevant for me"
dashboard
"Maybe we have some CI/CD dashboard and this is a user guide, or maybe its an overview of openhw project status"
docs

An OpenHW project dashboard. We could call this "OpenHW-Project-Dashboard" if that is more meaningful.

"Maybe shows newbeginners what openhw is and gives an overview of projects and repos"
process
"Here I might find "sign-off checklists", because that is a standardized process."
program
"Some administrative openhw stuff, not relevant for me"

Can we sync up with a meeting over zoom?
Duncan

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants