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

create content guidelines #877

Merged
merged 27 commits into from
Jan 15, 2020

Conversation

alexandra-simeonova
Copy link
Contributor

Description

Changes proposed in this pull request:

  • create guidelines for content

Related issue(s)
#815

@alexandra-simeonova alexandra-simeonova added the documentation documentation tasks label Oct 9, 2019
@alexandra-simeonova alexandra-simeonova added this to the Sprint 6 milestone Oct 9, 2019
@alexandra-simeonova alexandra-simeonova added the WIP Work in progress label Oct 9, 2019
@JohannesDoberer JohannesDoberer modified the milestones: Sprint 6, Sprint 7 Oct 14, 2019
@JohannesDoberer JohannesDoberer modified the milestones: Sprint 7, Sprint 8 Nov 5, 2019
@alexandra-simeonova alexandra-simeonova removed the WIP Work in progress label Nov 20, 2019
@zarkosimic zarkosimic self-assigned this Nov 20, 2019
Copy link
Contributor

@zarkosimic zarkosimic left a comment

Choose a reason for hiding this comment

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

LGTM! 👍

Copy link
Contributor

@bszwarc bszwarc left a comment

Choose a reason for hiding this comment

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

Added my review


Documentation on the Luigi website follows the structure below. When adding a new document, you need to place it into one of the five main categories depending on its topic.

**Basics**
Copy link
Contributor

Choose a reason for hiding this comment

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

I think these can also be subsections (###)

docs/content-guidelines.md Outdated Show resolved Hide resolved
docs/content-guidelines.md Outdated Show resolved Hide resolved
docs/content-guidelines.md Outdated Show resolved Hide resolved
docs/content-guidelines.md Outdated Show resolved Hide resolved
docs/content-guidelines.md Outdated Show resolved Hide resolved
docs/content-guidelines.md Outdated Show resolved Hide resolved

- Only use high resolution images
- Only use screenshots or diagrams if necessary, as too many of them can create visual noise
- As an alternative to screenshots, point to the [Luigi fiddle](https://fiddle.luigi-project.io/) or other Luigi examples when you want to illustrate a concept.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- As an alternative to screenshots, point to the [Luigi fiddle](https://fiddle.luigi-project.io/) or other Luigi examples when you want to illustrate a concept.
- As an alternative to screenshots, point to the [Luigi fiddle](https://fiddle.luigi-project.io/) or other Luigi examples when you want to illustrate a concept.

is it luigi fiddle or the luigi fiddle?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I changed it to "Luigi Fiddle"

docs/content-guidelines.md Outdated Show resolved Hide resolved

Luigi documentation exists in the form of Markdown files on GitHub, which are then transferred to the main documentation page using Sapper. Find more about what GitHub-flavored Markdown is [here](https://github.github.com/gfm).

Documentation is located in the `luigi/docs` folder in the [Luigi repository](https://github.com/SAP/luigi).
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Documentation is located in the `luigi/docs` folder in the [Luigi repository](https://github.com/SAP/luigi).
Documentation is located in the `luigi/docs` folder in the [Luigi repository](https://github.com/SAP/luigi).

it can also be documentation resides if you want to keep the active voice. But is located is also good :)

@alexandra-simeonova alexandra-simeonova merged commit 89d2f0d into SAP:master Jan 15, 2020
JohannesDoberer referenced this pull request in JohannesDoberer/luigi Feb 12, 2020
* master:
  Debug cypress travis issue (SAP#1097)
  Fix communication from external mf using customMessages (SAP#1081)
  fix fd-modal mix-up (SAP#1068)
  who is using luigi in about page (SAP#1077)
  Add cobrick logo (SAP#1072)
  who is using luigi button (SAP#1066)
  Update README.md
  Update README.md
  release v0.7.4 (SAP#1069)
  fix items calculation in more btn of tab nav(SAP#1065)
  Add valid href to navigation links (SAP#1034)
  fix runtime error when contextSwitcher is not defined (SAP#1047)
  Improve API documentation (SAP#1025)
  Improve authorization doc structure (SAP#1024)
  Improve Overview page (SAP#1000)
  Improve application-setup.md (SAP#965)
  create content guidelines (#877)
  Documentation fixes (SAP#1003)

# Conflicts:
#	docs/luigi-core-api.md
#	test/e2e.sh
stanleychh pushed a commit to stanleychh/luigi that referenced this pull request Dec 30, 2021
* create content guidelines

Co-authored-by: Zarko Simic <[email protected]>
Co-authored-by: Barbara Szwarc <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants