Roppongi.rb#8で「Make Rails Documents SEO(Search Engine Optimized)」を発表しました

Roppongi.rb #8にて「Make Rails Documents SEO(Search Engine Optimized)」と題して発表してきた。

発表スライド

railsdoc.github.io

発表では僕が過去に行ったいくつかのRails公式ドキュメントのSEO対応の紹介とともに、現在進めているプロジェクトであるrailsdoc.github.ioを紹介した。

GitHub: railsdoc/railsdoc.github.io: Rails API Documentation.

railsdoc.github.ioのゴール

• api.rubyonrails.orgをSEO強くする
• api.rubyonrails.orgを使いやすくする

下記はついでにできると良いなーと考えていること。

• フロントの技術を少しだけモダンに
  • bootstrapを使ってデザイン構成しやすくする
• GitHubといい感じの連携
• AMP対応もできると良さそう

railsdoc.github.ioの今後

発表内で紹介したが今後については下記のように考えている。

• コードベース整備中 & 未実装箇所の実装
• folk版sdocじゃない独自のドキュメント生成gemを作りたい

紹介したPR/Issue

• Introduce jekyll-seo-tag by toshimaru · Pull Request #88 · rails/weblog
• Add Jekyll SEO tag and Jekyll sitemap by benbalter · Pull Request #73 · rails/homepage
• Make Ruby on Rails Guides SNS-friendly by toshimaru · Pull Request #34860 · rails/rails
• No Rails 5 in apidock.com/rails · Issue #27633 · rails/rails

紹介したRails公式ドキュメント

1. rubyonrails.org
2. weblog.rubyonrails.org
3. guides.rubyonrails.org
4. api.rubyonrails.org

その他

• 発表にはDeckset 2を使った（ずっとDeckset1使ってたけど2にUpdateした）
• 何かあればイシューに書いてほしい github.com/railsdoc/railsdoc.github.io/issues