Setup Guide should indicate resources need to be moved to the distribution directory.

Open
#37 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Domain
documentation

Research direction

Start with the Setup Guide section covering installation and stylesheet creation. Update the instructions to move the demo and its CSS and image resources into the distribution directory, and clarify how the stylesheet and .md files should be arranged between the style and styleguide directories. Done means the guide documents the required manual resource moves and a practical stylesheet location.

Written by the indexing model from the issue text.

Description

guides

When installing DocJS and documenting an stylesheet, it is necessary to move:

  • the demo
  • the resources needed on the demo (css, img)

Currently in the guide we indicate that it is necessary to move just the demo. Ideally DocJS would take care of it, or a grunt task would need to be set. But until this is not done, we need to include this task as part of the guide.

Something to consider is to update the guide so that the stylesheet created can be easily moved to the styleguide directory with the demo. Currently we indicate to create the stylesheet under the style directory, but this is not practical if the .md files are also hosted in this location.

Dominant language
HTML
Stars
73
Forks
7
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from bitovi/documentcss

All issues in bitovi/documentcss

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.