firefox-addon - Firefox 插件中 doc/main.md 的用途？

Question

创建一个新的插件骨架后，里面没有任何内容doc/main.md，
并且插件 sdk 文档没有概述要保存在该文件中的特定数据格式。
它的目的是什么？
它是否应该包含与每个.js文件相关的特定数据？
还是完全由开发人员决定格式和/或内容？

rob@workLaptop:~/test$ cfx init
* lib directory created
* data directory created
* test directory created
* doc directory created
* README.md written
* generated jID automatically: jid1-hDoBEUyOVCBwuw
* package.json written
* test/test-main.js written
* lib/main.js written
* doc/main.md written

Your sample add-on is now ready.
Do "cfx test" to test it and "cfx run" to try it.  Have fun!
rob@workLaptop:~/test$ ls
data  doc  lib  package.json  README.md  test
rob@workLaptop:~/test$ cat doc/main.md 
rob@workLaptop:~/test$

Answer 1

扩展名 '.md' 指的是 Markdown 文件。

这些通常用于概述插件的功能。

语法/格式类似于 stackoverflow 上使用的语法/格式。您可以在此Markdown Cheatsheet中查看有关如何编写它的一些参考。

您还可以从那里的插件中查看 main.md 的一些示例，例如此处或此处