Skip to content

AlexWayfer/rubyapi

 
 

Repository files navigation

Ruby API: Easily Find Ruby documentation

View performance data on Skylight CI

Ruby API makes it easy and fast to search or browse the Ruby language API docs.

Why?

The existing websites for Ruby documentation are hard to search, and impossible to read on mobile devices. Ruby API provides instant search results, inspired by Dash, and a responsive design that's easy to read on any size device.

We aim to improve the Ruby ecosystem by being:

  • Readable on any size device
  • Fast on any speed internet connection
  • Relevant search results that surface useful APIs
  • Search engine optimized pages for every API method
  • Free, with no ads. Ever.

Getting started

Install dependencies:

$ ./bin/setup

Start ElasticSearch:

$ docker compose up -d

Start the Rails Server

$ ./bin/dev

Importing Documentation

Ruby's documentation can be imported very easily. There's a rake task that will let you import a given versions' documentation:

$ ./bin/rake import:ruby[3.1.0]

or you can easily import the latest versions of all currently supported versions of ruby:

$ ./bin/rake import:ruby:all

Running tests

The test suite can be executed with:

$ ./bin/rake test

Linting code

This project uses StandardRB for linting.

StandardRB can be executed with:

$ ./bin/standardrb

Note: This command may make changes to your code, to make it conform to the formatting rules of this project.

For instructions on running StandardRB in your editor, check out StandardRB's Documentation.

Code Of Conduct

Everyone interacting with the source code, issue trackers, chat rooms, and mailing lists is expected to follow the Code Of Conduct

License

Ruby API is licensed under the MIT license.

About

Ruby API makes it easy and fast to search or browse the Ruby language API docs

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 63.2%
  • Ruby 24.0%
  • Slim 6.8%
  • JavaScript 5.4%
  • CSS 0.5%
  • Shell 0.1%