change order

Author: khuyentran1401

how_to_write_good_articles.md

@@ -10,22 +10,24 @@ Articles put useful information inside other people's heads. Follow these tips t
 
 ## General Tips
 
-### Know Your Audience
-
-Understanding your audience is crucial for effective technical writing. Before writing, consider:
+### Don't Tell, Show
 
-- Their technical background and experience level
-- What problems they're trying to solve
-- What information they need to succeed
+Graphics and code snippets are more effective than text. Whenever possible, use them to explain your points instead of lengthy paragraphs.
 
-For CodeCut articles, we write for data scientists who:
+❌ Don't: Use only text to explain.
 
-- Are proficient in Python
-- Need to learn new tools quickly
-- Want practical, working examples
+> DuckDB is a fast, in-process SQL OLAP database management system. It supports standard SQL queries on Parquet and CSV files, and provides seamless integration with Python DataFrames. DuckDB is useful for analytics workloads on local data without needing a server.
 
-Focus on delivering exactly what they need - no more, no less. Cut any content that doesn't directly help them solve their problem.
+✅ Do: Use both text and code snippets to explain.
 
+> You can query a Parquet file directly using DuckDB with a single line of SQL:
+>
+>```python
+>import duckdb
+>duckdb.query("SELECT COUNT(*) FROM 'data.parquet'").show()
+>```
+>
+> This runs a SQL query on a local Parquet file without needing to load it into memory first.
 
 ### Use Action Verbs
 
@@ -41,24 +43,21 @@ SQL operations on DataFrames are provided by DuckDB without server setup.
 DuckDB provides SQL operations on DataFrames without server setup.
 ```
 
-### Don't Tell, Show
+### Know Your Audience
 
-Graphics and code snippets are more effective than text. Whenever possible, use them to explain your points instead of lengthy paragraphs.
+Understanding your audience is crucial for effective technical writing. Before writing, consider:
 
-❌ Don't: Use only text to explain.
+- Their technical background and experience level
+- What problems they're trying to solve
+- What information they need to succeed
 
-> DuckDB is a fast, in-process SQL OLAP database management system. It supports standard SQL queries on Parquet and CSV files, and provides seamless integration with Python DataFrames. DuckDB is useful for analytics workloads on local data without needing a server.
+For CodeCut articles, we write for data scientists who:
 
-✅ Do: Use both text and code snippets to explain.
+- Are proficient in Python
+- Need to learn new tools quickly
+- Want practical, working examples
 
-> You can query a Parquet file directly using DuckDB with a single line of SQL:
->
->```python
->import duckdb
->duckdb.query("SELECT COUNT(*) FROM 'data.parquet'").show()
->```
->
-> This runs a SQL query on a local Parquet file without needing to load it into memory first.
+Focus on delivering exactly what they need - no more, no less. Cut any content that doesn't directly help them solve their problem.
 
 ### Keep Paragraphs Short