Skip to content

Initial glossary #3568

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

Merged
merged 2 commits into from
Oct 9, 2017
Merged

Initial glossary #3568

merged 2 commits into from
Oct 9, 2017

Conversation

fabaff
Copy link
Member

@fabaff fabaff commented Oct 9, 2017

Description:
A very simple glossary that uses a data file.

Something like glossarizer could replace the glossary in the future.

Related issue (if applicable): fixes #3263

@fabaff fabaff added Enhancement Hacktoberfest An PR on this issue (or the PR itself) is eligible towards Hacktoberfest! labels Oct 9, 2017
@@ -0,0 +1,17 @@
- topic: Platform
description: A platform makes the connection to a specific software or hardware platform. The `pushbullet` platform works with the service from pushbullet.com.
- topic: Component
Copy link
Contributor

@arsaboo arsaboo Oct 9, 2017

Choose a reason for hiding this comment

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

We should move component above platform to maintain the hierarchy. A component can have multiple platforms. Also, this may be a good place to clear up the confusion between platform and component. For example, Abode component provides the underlying core logic and infrastructure that can be used by individual platforms (e.g., Alarm, sensors, etc. ). I can make the change after this is merged.

Copy link
Member

Choose a reason for hiding this comment

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

Based on the sort order, I think component will appear well above platform. Right now it appears to be sorted in alphabetical order by topic.

Copy link
Member Author

Choose a reason for hiding this comment

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

| sort: 'topic' will do the sorting.

This is hopefully just a start. Collecting the details and provide an easy to understand description is the hard part. Nice formatting can be done later 😉

@fabaff
Copy link
Member Author

fabaff commented Oct 9, 2017

OK, let's merge it.

@fabaff fabaff merged commit 82dea44 into current Oct 9, 2017
@fabaff fabaff deleted the glossary branch October 9, 2017 18:48
@fabaff fabaff mentioned this pull request Oct 13, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Hacktoberfest An PR on this issue (or the PR itself) is eligible towards Hacktoberfest!
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants