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

feat: add readme template #1

Open
wants to merge 17 commits into
base: main
Choose a base branch
from
Open

feat: add readme template #1

wants to merge 17 commits into from

Conversation

aymanbagabas
Copy link
Member

Add organization readme with our repositories

Copy link
Member

@bashbunni bashbunni left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great, excited to discuss further!

@@ -0,0 +1,50 @@
### Repos
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I feel like before getting into the repos, we should plug our website, twitter, and youtube to let them know that we have an active online presence and encourage them to join the community. Ideally once we start hosting regular events (tbd on dates) we can feature that here too so they can join in!

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

these info are already included in the overview header
image

- Wish List: The SSH directory ✨ [{{ .Title }}]({{ .URL }}) (_released {{ humanize .PublishedAt }}_)
{{- end }}

### Getting in touch
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This could be at the top and possibly changed to "Join the Community" or "Join the Community, We Have Cookies/mochi/ice cream/etc"

@aymanbagabas aymanbagabas requested a review from bashbunni August 22, 2022 15:33
@bashbunni
Copy link
Member

Ah I think this would be worth discussing in our weekly meeting!

@aymanbagabas
Copy link
Member Author

This would be useful here muesli/markscribe#48 instead of using Github Atom feed to determine the last release, we could use this to get the number of stars, last release, and description straight from the Github API. So updating a repo's description from the repo's page will automatically update it here.

@bashbunni
Copy link
Member

I tried using the markscribe on master to include ayman's commit there, but got immediately rate limited for the GH API. Atom gave good results. Either way, it's important to have examples here. Would be cool to use a template to generate this README in the future with examples, but we would need to host 'em in a single spot following a naming convention. For now, it's a lower lift to use the README I wrote up

@bashbunni
Copy link
Member

TODO: need to add a different charm logo at the top probably @meowgorithm

preview: https://github.com/charmbracelet/.github/tree/add-readme/profile

@bashbunni
Copy link
Member

Ready for review!

Copy link
Member Author

@aymanbagabas aymanbagabas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What's the difference between AUTOREADME.md and README.md? @bashbunni keep in mind that the current markscribe workflow will use templates/README.md.tpl to generate profile/README.md
https://github.com/charmbracelet/.github/blob/main/.github/workflows/readme-scribe.yml

templates/README.md.tpl Outdated Show resolved Hide resolved
templates/README.md.tpl Outdated Show resolved Hide resolved
@bashbunni
Copy link
Member

bashbunni commented Jul 9, 2024

  • fix link to profile/CHARMWORLD.md (let's move charmworld to another iteration)
  • link blog author names to GitHub profiles
  • link to each of the repos
  • sort repos by most recently released -> blog posts and repos
  • what we've been working on: latest releases/activity for repo ordering instead of the projects that are currently there
  • change "what's the 411?"
  • remove charm world for now, link to those demos in for the featured projects section
  • remove feedback + license
  • log uses dynamic charm logo - use purple for light and cream for dark (N/A)
  • figure out where "last released on a long while ago" comes from in the templates (N/A)

bashbunni and others added 2 commits July 9, 2024 13:14
* add stargazing section

* refactor: update README

* refactor: use updated orgPopularRepos

* refactor: reformat blog section

* refactor(README): improve layout of blogz

* refactor(README): remove outdated section

* refactor: use updated popularRepos function

* feat: map authors in template file
@bashbunni bashbunni requested a review from meowgorithm August 9, 2024 22:18
profile/README.md Outdated Show resolved Hide resolved
profile/README.md Outdated Show resolved Hide resolved
Copy link
Member

@bashbunni bashbunni left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stargazing releases are showing the oldest release instead of the latest release. Need to fix that in markscribe

Copy link
Member

@bashbunni bashbunni left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed the releases

@bashbunni
Copy link
Member

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

Successfully merging this pull request may close these issues.

3 participants