タグ

documentに関するy-imayaのブックマーク (3)

  • ESDocという(多分)モダンなドキュメンテーションツールの紹介 - maru source

    こんにちは丸山@h13i32maruです。 僕は2015年からESDoc*1というJavaScript向けのドキュメンテーションツールを開発しています。 https://esdoc.org https://github.com/esdoc/esdoc Star 最初のリリースから2年、昨日ようやくv1.0をリリースできました🎉 いやー、ここまで長かったです。今ではRxJSやSketchAPIなど、様々なツールで使用されています。 この2年間、ESDocは2つのゴールを目指して開発してきました。 ドキュメントの作成・メンテナンスを快適にする(ドキュメントを書くの楽しい!という状態) ソフトウェアの使い方を簡単に理解できるドキュメントを作成する(ソースコード読まなくても大丈夫!という状態) この2つを満たすためにESDocは色々な機能を提供しています。 今日はそれらの機能の中でも(多分)モダ

    ESDocという(多分)モダンなドキュメンテーションツールの紹介 - maru source
  • Scrapbox - A new style of team wiki

    Effortless ideation.Type brackets around an `[idea]` to create a new link or see auto-complete results. You can instantly click to jump to a new page and keep typing ideas. Compound organization.As you add more pages your ideas get more and more organized. By adding a single link you can see new connections to dozens of related pages. Frictionless focus.Paste links to embed. Share code with syntax

    Scrapbox - A new style of team wiki
  • ESDoc を試す - アカベコマイリ

    すると esdoc ディレクトリ内に解析結果となる HTML ファイルなどが出力される。 ESDoc をプロジェクトのローカルで使用する 最近 npm はなるべくプロジェクトのローカルにインストールしている。グローバルだと npm が更新されたときに依存しているプロジェクトすべてが影響を受ける。互換性の問題が起きたりしたら一大事だ。プロジェクトのローカルならそのような心配は無用である。 package.json で npm バージョンを管理することで、プロジェクトが必要とする依存も明示できる。ファイルを Git リポジトリなどで管理していれば環境の共有や復元も容易だ。 というわけで ESDoc もローカルへインストール。package.json の置かれたディレクトリで以下のコマンドを実行。ESDoc は開発用なので -D オプションをつけて package.json の devDepen

  • 1