documentation Archive

สวยดีนะ กับ Diagram as a Code (DaaC)

มาลองสร้าง Diagram หรือแผนภาพแสดงโครงสร้างของระบบต่าง ๆ ไม่ว่าระบบทำการ implement บน AWS, Azure, GCP และ Kubernetes นั้น สามารถสร้างง่าย ๆ ด้วยการเขียน code ภาษา Python โดยใช้งาน library ชื่อว่า  Diagrams มาลองใช้งานกัน

Read More…

มาลองเขียน Flow chart และ Sequence diagram ด้วย MermaidJS กัน

พอดีต้องเขียนเอกสารอธิบายขั้นตอนการทำงานของระบบงานนิดหน่อย ถ้าจะเขียนแบบใช้ program มาช่วย มันดูจะลำบากเกินไปหน่อย เลยคิดว่า ถ้าเขียนเป็นไฟล์ในรูปแบบ Markdown แล้วทำการแปลงมาอยู่ในรูปแบบต่าง ๆ ได้เลยเช่นรูปและ pdf น่าจะสะดวกกว่า แถมสามารถเก็บไฟล์ Markdown ไว้ใน Version Control System ได้อีกด้วย จึงลองไปหาดูว่ามีอะไรให้ใช้บ้าง

Read More…

ทำความรู้จักกับ Stack Overflow Documentation 

ทาง StackOverflow ได้เปิดระบบที่เรียกว่า Documentation เป็นอีกแหล่งความรู้สำหรับนักพัฒนา software โดยเฉพาะ โดยข้อมูลต่าง ๆ ของระบบมาจาก community นั่นเอง ซึ่งเน้นในเรื่องของตัวอย่าง ตัวอย่าง และ ตัวอย่าง code ดังนั้นพลาดไม่ได้ด้วยประการทั้งปวง มาทำความรู้จักกับ Stack Overflow Documentation กัน ซึ่งสรุปจากบทความเรื่อง Introducing Stack Overflow Documentation Beta

Read More…