brooklyn-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From geomacy <...@git.apache.org>
Subject [GitHub] incubator-brooklyn pull request: Add a "quick overview of concepts...
Date Mon, 19 Oct 2015 16:29:37 GMT
Github user geomacy commented on a diff in the pull request:

    https://github.com/apache/incubator-brooklyn/pull/966#discussion_r42393337
  
    --- Diff: docs/guide/start/concept-quickstart.md ---
    @@ -0,0 +1,35 @@
    +---
    +title: Brooklyn Concepts Quickstart
    +layout: website-normal
    +menu_parent: index.md
    +---
    +
    +The following section gives a quick summary of the main Brooklyn concepts you will encounter
in Getting Started.  For later investigation of these concepts see [The Theory Behind Brookln]({{site.path.website}}/learnmore/theory.html),
and the detailed description in [Brooklyn Concepts]({{site.path.guide}}/concepts/).
    --- End diff --
    
    My thought when working through the Getting Started was that it would be helpful to have
an "in-line" definition of the main concepts, as part of Getting Started.  This is following
our wider observation that the Getting Started could be more linear in form, and more self
contained (reader doesn't have to jump to other pages to get information and then come back).
 But if there's general impression that it would be preferable I can replace this with a link
to the glossary?


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

Mime
View raw message