Skip to content

Commit da697d9

Browse files
authored
feature: add a content explanation
1 parent 92cdfc0 commit da697d9

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

README.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,21 @@ bundle install
99
bundle exec jekyll serve
1010
```
1111

12+
## Content
13+
14+
Welcome to our official technology blog. The idea is to share with the Community about our technology challenges. A blog post in an engineering blog should show readers what in-house engineering teams are actually working on. Engineering posts help peers understand what a particular individual or team within a much larger organization actually works on, keeping sales and marketing to an absolute minimum. These posts tell us about an engineering team’s philosophy as well as their stack.
15+
But they're be educational. Well-written blog posts offer unique perspectives and different solutions to old problems. They help the reader learn about a specific topic and technology, and walk readers through how that topic/technology is applied to help the team work through a challenge. Readers should learn something new.
16+
17+
Regardless of the topic, the first question to ask yourself is, "Why should a reader care?" Readers don't just want to look at a blog post and say, "Cool, Company X did this thing...." and that's it. At the very least, they want to understand:
18+
19+
- Why was this approach taken?
20+
- What went into deciding on that approach?
21+
- What is this [topic/software/etc] that was chosen and why?
22+
- What lessons came out of it?
23+
24+
Engineering blog posts are not just about "show and tell"; they're how our engineering teams shares knowledge with peers across the wider tech community. And engineering blog posts provide value to the engineers writing them; they increase an engineer's profile and they give the engineer the chance to share what they've worked on. Also, they're a great way of attracting new candidates ;-)
25+
26+
1227
## Publishing an article
1328

1429
* Branch out of `main` branch.

0 commit comments

Comments
 (0)