Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Move documentation into main repository #363

Merged
merged 2 commits into from
Jan 15, 2016
Merged

Move documentation into main repository #363

merged 2 commits into from
Jan 15, 2016

Conversation

c-lliope
Copy link
Contributor

Problem:

Documentation is being kept at
https://github.com/thoughtbot/administrate-docs.

It is difficult to maintain documentation when it is kept in a separate
repository from the rest of the app.

So far, there has only been one documentation pull request. We'd like to
encourage more people to submit documentation suggestions.

Solution:

  • Move documentation from its original source
    to within the main Administrate repo.
  • Copy over all existing styles from the documentation app.

markdown = Redcarpet::Markdown.new(
Redcarpet::Render::HTML,
:fenced_code_blocks => true,
:autolink => true,

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use the new Ruby 1.9 hash syntax.

@@ -0,0 +1,117 @@
$blue: #53ADC6;

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Color #53ADC6 should be written as #53adc6

@c-lliope
Copy link
Contributor Author

@danbee the visual regressions are unrelated to this PR. I've written up a description of the problem, along with fixes, in #408.

We should look into upgrading our Percy plan.

Because the regressions aren't coming from this code, I'm okay moving forward on this.

@c-lliope
Copy link
Contributor Author

Also, because we haven't approved the Percy diffs for this PR, future diffs won't be compared against this. They'll be compared against the last commit on master that was approved. Yay!

$blue: #8fbdcc;
$cyan: #b95c56;
$yellow: #f8d29d;
$red: #b95c56;
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move these colors to the top of the file, pls. Even better, move them to variables.scss

@c-lliope c-lliope force-pushed the gw-docs branch 2 times, most recently from a51aff7 to df881ad Compare January 15, 2016 22:12
Problem:

Documentation is being kept at
https://github.com/thoughtbot/administrate-docs.

It is difficult to maintain documentation
when it is kept in a separate repository
from the rest of the app.

So far, there has only been one documentation pull request.
We'd like to encourage more people to submit documentation suggestions.

Solution:

- Move documentation from its original source
  to within the main Administrate repo.
- Copy over all existing styles from the documentation app.
@c-lliope c-lliope merged commit cdb1d50 into master Jan 15, 2016
@c-lliope c-lliope deleted the gw-docs branch January 15, 2016 22:22
@danbee
Copy link
Contributor

danbee commented Jan 15, 2016

@Graysonwright Apologies for not getting to look at this today.

@c-lliope
Copy link
Contributor Author

oh, no worries! I was working with Tyson a bit on CSS stuff mostly.

c-lliope added a commit that referenced this pull request Jan 22, 2016
Changes:

```
* [#269] [FEATURE] Add a generator for copying default layout files
* [#328] [FEATURE] Add a generator for copying default sidebar partial
* [#362] [FEATURE] Add a generator for only the dashboard manifest.
  Customizing this manifest before running the `administrate:install` generator
  will change which dashboards get generated.
* [#295] [FEATURE] Add dashboard detection for ActiveRecord::Enum fields.
* [#364] [FEATURE] Improve dashboard generator by explicitly listing out the
  generated `SHOW_PAGE_ATTRIBUTES` array elements.
* [#416] [UI] Add an accessibility label to the search input
* [#411] [UI] Use tabular figures in table cells
* [#409] [UI] Use default system fonts
* [#424] [BUGFIX] Fix a bug where running `rails destroy GENERATOR_NAME`
  would not work for several of the generators
* [#390] [BUGFIX] Fix timestamp deprecation warnings
* [#365] [COMPAT] Remove dependency on `inline_svg`
* [#396] [I18n] Ukrainian
* [#297] [I18n] Italian
* [#307] [I18n] Fix German grammatical errors
* [#363] [DOC] Move documentation into main repository, at the root URL
* [#395] [DOC] Update inline documentation for collection partial
* [#387] [DOC] Fix incorrect path for generators in the docs
```
@c-lliope c-lliope mentioned this pull request Jan 22, 2016
c-lliope added a commit that referenced this pull request Jan 22, 2016
Changes:

```
* [#269] [FEATURE] Add a generator for copying default layout files
* [#328] [FEATURE] Add a generator for copying default sidebar partial
* [#362] [FEATURE] Add a generator for only the dashboard manifest.
  Customizing this manifest before running the `administrate:install` generator
  will change which dashboards get generated.
* [#295] [FEATURE] Add dashboard detection for ActiveRecord::Enum fields.
* [#364] [FEATURE] Improve dashboard generator by explicitly listing out the
  generated `SHOW_PAGE_ATTRIBUTES` array elements.
* [#416] [UI] Add an accessibility label to the search input
* [#411] [UI] Use tabular figures in table cells
* [#409] [UI] Use default system fonts
* [#424] [BUGFIX] Fix a bug where running `rails destroy GENERATOR_NAME`
  would not work for several of the generators
* [#390] [BUGFIX] Fix timestamp deprecation warnings
* [#365] [COMPAT] Remove dependency on `inline_svg`
* [#396] [I18n] Ukrainian
* [#297] [I18n] Italian
* [#307] [I18n] Fix German grammatical errors
* [#363] [DOC] Move documentation into main repository, at the root URL
* [#395] [DOC] Update inline documentation for collection partial
* [#387] [DOC] Fix incorrect path for generators in the docs
```
@pmaojo
Copy link

pmaojo commented Feb 25, 2016

Wouldn't it be good to make the docs responsive?

@c-lliope
Copy link
Contributor Author

@pmaojo - I agree, that would be great!

If you'd like to take a look at that, feel free to open a new PR. This is already closed, so there's not much we can do here.

@pmaojo
Copy link

pmaojo commented Jun 23, 2016

@Graysonwright as I see now the documentation is in the main repo as md files, not as html.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants