ドキュメントの継続的な開発方法 | IIJ Engineers Blog
私はソフトウェア開発を主体とするエンジニアで、 クラウドサービスの開発・運用 分散処理技術の検証とサービス利用の検討 社内の開発支援環境の開発・運用 などの業務に従事していますが、今回の記事は業務とは直接的な関係は無く、私が会社で勝手自発的に行っている取り組みについて書きたいと思います。 昨今、インターネットは生活に深く浸透し、クラウドサービスを利用することで安く簡単にWebサービスを開発、公開できるようになりました。Web技術の進化や流行の移り変りも非常に激しく、既存サービスの機能追加や新規サービスの開発は頻繁に行われています。それは弊社も例外ではありません。 このような開発の現場では、リーンソフトウェア開発への取り組みなど開発手法の最適化が積極的に行われ、様々なベストプラクティスが生みだされています。それらのベストプラクティスには、 継続的インテグレーション や 継続的デプロイメント
textlintで文章カバレッジレポートを継続的に見ていく
以前、技術文書をソフトウェア開発する話でtextlintやGitBookを使って文書を開発する方法についてお話しました。 その時に、自然言語のチェックの自動化などはまだ色々考えられることがあるという話をしました。 文書のテストはまだまだ色々できることがある カバレッジを取るとかメトリクスを取るとか – まとめ1 | 技術文書をソフトウェア開発する話 そこで文章のカバレッジというものを考えて実装してみました。 textlintとコードカバレッジの仕組みを使ったものですが、こういうのをなんと呼べばいいのかよくわからなかったので、ここではとりあえず”文章カバレッジ”と読んでいます。 textlintは全ての文に対してLintを実行するので命令網羅と近い感じがします。 命令網羅（statement coverage：SC） コード内のすべての命令が少なくとも1回は実行されるようにテストを設計する。
JTF日本語標準スタイルガイドのルールセットで文章をチェックできるtextlintプリセット
昨日、textlint 4.0をリリースしましたが、textlintはMarkdownなどの文章に対してルールベースでチェックできるツールです。 詳しくは以下の記事を参照してください。 textlintで日本語の文章をチェックする | Web Scratch textlint + prhで表記ゆれを検出する | Web Scratch 今すぐ電子書籍(技術書)を書き始める方法と文章の自動チェック | Web Scratch textlint-rule-preset-jtf-style textlintのプリセット(ルールセット)としてtextlint-rule-preset-jtf-styleを作成しました。 これへ日本翻訳連盟のJTF日本語標準スタイルガイド（翻訳用）をtextlintのルールとして実装したものです。 『JTF日本語標準スタイルガイド（翻訳用）』は、実務翻訳において和訳時
校正ツール textlint 4.0リリース
textlint 4.0をリリースしました。 Release 4.0.0 · azu/textlint textlintはMarkdownなどの文章に対するESLintのようなLintツールですが、詳しくは以下の記事を参照してください。 textlintで日本語の文章をチェックする | Web Scratch textlint + prhで表記ゆれを検出する | Web Scratch 今すぐ電子書籍(技術書)を書き始める方法と文章の自動チェック | Web Scratch textlint 4.0では以下のような変更が含まれています。 3.7.1…4.0.0 Breaking Change TextLintMessageのcolumnsが1-basedに変更されました #38 この破壊的変更はtextlintをライブラリとして利用しているユーザに関係します(use-as-modules.
textlintで日本語の文章をチェックする
textlintはMarkdownなどテキスト向けのLintツールで、テキスト版ESLintみたいな感じのツールです。 JavaScriptでルールを書けるテキスト/Markdownの校正ツール textlint を作った | Web Scratch 最近azu/JavaScript-Plugin-Architectureという小さな書籍を書いていて、色々簡単に使えるような仕組みを追加しています。 この記事では簡単なtextlintの導入方法について紹介します。 公式サイトには一部ルールを含むオンラインデモが公開されています。 textlint · The pluggable linting tool for text and markdown ドットインストールにてNode.jsのインストール、textlintの利用方法、エディタとの連携などのチュートリアルが公開されています。Node.
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
