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

Getting started section path and title rename #27

Closed
2 tasks
chalin opened this issue Aug 27, 2024 · 7 comments
Closed
2 tasks

Getting started section path and title rename #27

chalin opened this issue Aug 27, 2024 · 7 comments
Assignees

Comments

@chalin
Copy link
Collaborator

chalin commented Aug 27, 2024

Originally posted by @chalin in #20 (comment)

This page shouldn't exist under /get-started/, but we'll address this separately. I'll file an issue.

Actually, there are a few issues to address:

  • Rename the get-started section to getting-started so as to match the original TUF site
  • @Dindihub, you probably based the section on the corresponding section of the OTel site, but I don't think that it makes sense here to identify "Adopters" and "Contributors" as roles here. @lukpueh WDYT?
@Dindihub
Copy link
Owner

Originally posted by @chalin in #20 (comment)

This page shouldn't exist under /get-started/, but we'll address this separately. I'll file an issue.

Actually, there are a few issues to address:

  • Rename the get-started section to getting-started so as to match the original TUF site
  • @Dindihub, you probably based the section on the corresponding section of the OTel site, but I don't think that it makes sense here to identify "Adopters" and "Contributors" as roles here. @lukpueh WDYT?

Hi @chalin. The Get-started section was supposed to contain information for new users to understand the project.

For context, one of the key issues that came out of the TUF analysis was that the website did not have new user content. So creating this section was my attempt to have a guide for new users. I discussed it with @lukpueh and we decided to group new users into Adopters and contributors.

  1. Adopters: Integrate TUF security properties into new and existing content delivery systems. Adopters can be classified into two categories:
  • Client maintainers: depend on repository maintainers, to provide a TUF repo. And they can choose from multiple TUF client implementations (python-tuf, go-tuf, etc.) Typically, they will pick the language their client is written in.
  • Repository maintainers: Use either an existing TUF repository implementation (tuf-on-ci, RSTUF), or roll their own (typically using a tuf repository library such as python-tuf, go-tuf, etc.)
  1. Contributors: want to contribute either to the spec or documentation.
  • Spec contributors
  • Docs contributors

But if the section doesn't bring any value to the site I'm okay getting rid of it.

@lukpueh
Copy link
Collaborator

lukpueh commented Aug 28, 2024

IMO the classification makes sense.

@chalin
Copy link
Collaborator Author

chalin commented Aug 28, 2024

IMO the classification makes sense.

If it works for @lukpueh, I'm ok keep it as is.

Though, let's fix the section path name and title to match the old site.

@chalin
Copy link
Collaborator Author

chalin commented Aug 28, 2024

Will close this for now, and revisit later if necessary.

@chalin chalin closed this as not planned Won't fix, can't repro, duplicate, stale Aug 28, 2024
@chalin chalin reopened this Aug 28, 2024
@chalin
Copy link
Collaborator Author

chalin commented Aug 28, 2024

Oops, forgot that the path rename was being tracked via this issue. Reopening :)

@chalin chalin changed the title Getting started rework Getting started section path and title rename Aug 28, 2024
@chalin
Copy link
Collaborator Author

chalin commented Oct 4, 2024

I kept the page, renaming it to Getting started, but refactored the content a bit. For details, see:

which closes this issue.

@chalin chalin closed this as completed Oct 4, 2024
@Dindihub
Copy link
Owner

Dindihub commented Oct 5, 2024

I kept the page, renaming it to Getting started, but refactored the content a bit. For details, see:

which closes this issue.

Noted. Thanks

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