From 7167a6f33acb607974eeec0a2c331c5fb7c73472 Mon Sep 17 00:00:00 2001 From: Sean Massa Date: Fri, 29 Sep 2023 21:51:31 -0500 Subject: [PATCH] add more old articles --- README.md | 9 ++ app/article-data.js | 30 ++++ app/components/article-card.gjs | 2 +- app/components/article-header.gjs | 2 +- .../articles/conventional-comments.md | 77 +++++++++++ .../articles/detangling-the-code-review.md | 111 +++++++++++++++ .../articles/detangling-the-manager.md | 96 +++++++++++++ .../articles/detangling-the-standup.md | 130 ++++++++++++++++++ app/templates/articles/theme-pact.md | 111 +++++++++++++++ 9 files changed, 566 insertions(+), 2 deletions(-) create mode 100644 app/templates/articles/conventional-comments.md create mode 100644 app/templates/articles/detangling-the-code-review.md create mode 100644 app/templates/articles/detangling-the-manager.md create mode 100644 app/templates/articles/detangling-the-standup.md create mode 100644 app/templates/articles/theme-pact.md diff --git a/README.md b/README.md index 18ffdaa..458f959 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,11 @@ # ember-blog +## To Do + +- ensure articles are sorted by date +- scroll to top on link clicking +- manually check links +- add redirects for old slug to new slug +- 404 protection: https://remysharp.com/2023/09/26/no-more-404 +- allow `published: false` + diff --git a/app/article-data.js b/app/article-data.js index 362598e..6616755 100644 --- a/app/article-data.js +++ b/app/article-data.js @@ -11,6 +11,36 @@ let articles = "title": "An Incremental Approach to Linting to Your Projects", "date": "2017-08-08", "description": "I have gone through the process of adding linting to existing, large projects a couple of times. I've learned some lessons about how to approach this so that it's not disruptive to the team doing other work. Follow these steps to get robust linting into your project without pulling team velocity to a halt!" + }, + { + "slug": "detangling-the-manager", + "title": "Detangling the Manager: Supervisor, Team Lead, Mentor", + "date": "2021-11-18", + "description": "The term Manager means a lot of different things to different companies. It can include Project Manager, Product Manager, Technical Lead, Team Lead, Mentor, Coach, Supervisor, as well as Individual Contributor. Most often, in my experience, a manager is responsible for at least these roles: Supervisor, Mentor, and Team Lead.

There is great value in having those roles played by separate people." + }, + { + "slug": "detangling-the-standup", + "title": "Detangling the Standup: Status Reports, Team Planning, Context Sharing, and Community Building", + "date": "2022-01-04", + "description": "Standups are often applied without understanding the problem they are solving. This leads to:

1. Not clearly solving a specific problem
2. Not solving a problem with the best solution
3. A daily interruption to deep work

What follows is a pragmatic and ideal approach to resolving this situation. The pragmatic approach is to understand so you can excel within that system. The ideal solution tries to change the system to better serve the team." + }, + { + "slug": "detangling-the-code-review", + "title": "Detangling the Code Review: Questions, Preferences, Suggestions, Conventions, Requirements", + "date": "2022-03-14", + "description": "Teams can have more effective code reviews if they default to approval and have a framework for delivering and managing feedback." + }, + { + "slug": "conventional-comments", + "title": "Conventional Comments: Streamlining Feedback", + "date": "2022-03-15", + "description": "How I use Conventional Comments to make it clear (1) what kind of comment it is, (2) what specifically I want, and (3) how important it is that my comment is resolved." + }, + { + "slug": "theme-pact", + "title": "Theme Pact: Goal Setting Framework with no Goals", + "date": "2023-02-02", + "description": "Pulling from several sources, my framework for goal setting includes:
" } ] export default articles; diff --git a/app/components/article-card.gjs b/app/components/article-card.gjs index ddab956..ee65ecf 100644 --- a/app/components/article-card.gjs +++ b/app/components/article-card.gjs @@ -7,7 +7,7 @@ import { LinkTo } from '@ember/routing'; @model={{@article}}> {{@article.title}} -

{{@article.description}}

+

{{{@article.description}}}

{{@article.date}}

diff --git a/app/components/article-header.gjs b/app/components/article-header.gjs index 3206992..043c9e7 100644 --- a/app/components/article-header.gjs +++ b/app/components/article-header.gjs @@ -5,7 +5,7 @@ import { LinkTo } from '@ember/routing';
{{@article.title}}
-

{{@article.description}}

+

{{{@article.description}}}

{{@article.date}}

diff --git a/app/templates/articles/conventional-comments.md b/app/templates/articles/conventional-comments.md new file mode 100644 index 0000000..c5a6016 --- /dev/null +++ b/app/templates/articles/conventional-comments.md @@ -0,0 +1,77 @@ + + +The idea behind [Conventional Comments](https://conventionalcomments.org/) on Code Reviews is that structure can convey a lot meaning quickly. + +This process helps convey understanding of: + +- what change is suggested +- why it matters +- how important it is to change now + +You can use the process [as documented by the author](https://conventionalcomments.org/), but I like using the following the following customized version. + +## Streamlined Conventional Comments + +All comments must be resolved before merging, but resolution can look different for different kinds of comments. + +All comments are also non-blocking unless otherwise specified. + +### Format + +```jsx +