You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@mesos.apache.org by "Greg Mann (JIRA)" <ji...@apache.org> on 2017/10/20 17:43:00 UTC

[jira] [Commented] (MESOS-8117) Update Getting Started documentation

    [ https://issues.apache.org/jira/browse/MESOS-8117?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16212940#comment-16212940 ] 

Greg Mann commented on MESOS-8117:
----------------------------------

{code}
commit 8386e22f20d9d20836df6111221cb3afdaf2a3ba
Author: Andrew Schwartzmeyer <an...@schwartzmeyer.com>
Date:   Fri Oct 20 10:37:24 2017 -0700

    Moved building docs to `building.md`.

    The existing "Getting Started" documentation does not cover how to "get
    started" with Mesos, but instead how to build it from source on multiple
    platforms. Also added a link to `configuration.md` in the build
    documentation section, as it was not obvious.

    Review: https://reviews.apache.org/r/63093/
{code}
{code}
commit b71478750dce4a26d84c1840a4e6d73349a6f0db
Author: Andrew Schwartzmeyer <an...@schwartzmeyer.com>
Date:   Fri Oct 20 10:37:25 2017 -0700

    Added the Getting Started landing page.

    After moving the build documentation to its own page, we can now have a
    real "Getting Started" page suitable for anyone to get started with
    Mesos. It is purposefully short, and therefore not overwhelming.

    Review: https://reviews.apache.org/r/63095/
{code}

> Update Getting Started documentation
> ------------------------------------
>
>                 Key: MESOS-8117
>                 URL: https://issues.apache.org/jira/browse/MESOS-8117
>             Project: Mesos
>          Issue Type: Improvement
>          Components: documentation
>            Reporter: Andrew Schwartzmeyer
>            Assignee: Andrew Schwartzmeyer
>              Labels: docuentation, microsoft
>             Fix For: 1.5.0
>
>
> Our "getting started" landing page is not how to get started on Mesos, it's how to build. Build instructions should exist in their own file, and the getting started page should be more like a landing page such as the community page is. As someone who has onboarded other developers, I speak from experience saying we need real "getting started" info.
> This work was started at the docathon at Mesosphere a couple weeks ago.



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)