Re: [討論] 要不要寫註解

[shter (飛梭之影)]

借這問題問一下

程式要不要寫註解有爭議，但設定檔 (如 httpd.conf ) 都是有註解的
不過近年來因為 JSON 格式與 web 的流行
不少專案開始把新的設定檔用 json 的樹狀結構寫了

問題是
過去 .conf 的設定檔只要加一行 # 開頭的就變註解了
但在 json 裡似乎也不吃 javascript 的 // 或 /* */ ??
最後看到的解法大部分是 key 寫成
"//_name": "description....",
或是
"//": "name and description..,


相比起程式碼
其實設定檔也有不少註解需求要說明這個值是做什麼的，定義的格式及數值範圍為何

不知道大家是怎麼在 json 格式檔案寫註解?

--
[LINE 台幣匯率機器人]  https://line.me/R/ti/p/sCsZnuBg5V
即時台銀匯率，可計算退稅價格，出國血拼直接輸入貨架金額查詢退稅後台幣價。
打招呼會告訴你使用說明 講日幣就會將匯率切成日幣模式 之後打數字就會自動轉換
===============================================================
新增筆記本功能可紀錄外幣消費、比價用途，並利用所查價格開啟團購功能
https://youtu.be/ttayJLYa7Oc

--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 111.250.17.73 (臺灣)
※ 文章網址: https://www.ptt.cc/bbs/Soft_Job/M.1572143564.A.2D0.html
→ petercoin: 我都參考VSCode的設定檔內的寫法
→ abccbaandy: 解法就是換一種格式阿XD
→ x000032001: 用yaml或toml就好了啊
推 touurtn: 現在設定檔比較流行YAML或TOML吧
推 othree: 直接用 js 檔案格式 export 物件也可以，現在也很多這樣的
→ othree: JSON 作者故意拿掉註解的，因為他發現有當 directive 用的
→ othree: JSON 比較適合資料交換用
→ x246libra: 請問樓上 export 物件後，要怎麼給其他程式使用?
→ x246libra: 通常似乎都是直接讀取config.json 如果換成config.js
→ x246libra: 原本的程式該怎麼拿到資料 不懂js 所以請叫你
推 othree: 我是假設是 nodejs 的程式，所以直接 import 就可以了
推 sxy67230: 我還沒遇過設定檔用json寫的，我是後端的yaml還是主流。
→ sxy67230: 早期寫c++是用一個constants寫，現在這種寫法比較少了。
推 Phenomenon: 用 yaml 或 jsonnet