Mailing-List: contact dev-help@brooklyn.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@brooklyn.apache.org
From: Valentin Aitken <valentin.aitken@cloudsoftcorp.com>
Subject: Re: Brooklyn website
To: dev@brooklyn.apache.org
References: <82448ad0-5759-fa9f-be30-cd1aed34c1a9@cloudsoft.io>
 <249cb567-942c-548a-a92f-a818a2305a75@cloudsoft.io>
 <CABXp0fSLFKX-7LxTu3TXGNRf+MAV0Ysh1Wc=xB4N7YkhyLBy9A@mail.gmail.com>
Message-ID: <b2a3ea43-debb-d9f6-2b8b-1db224d01638@cloudsoft.io>
Date: Thu, 13 Apr 2017 18:14:01 +0300
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101
 Thunderbird/45.8.0
MIME-Version: 1.0
In-Reply-To: <CABXp0fSLFKX-7LxTu3TXGNRf+MAV0Ysh1Wc=xB4N7YkhyLBy9A@mail.gmail.com>
Content-Type: multipart/alternative;
 boundary="------------272907951FDCD1158F9719B8"
archived-at: Thu, 13 Apr 2017 15:14:15 -0000

--------------272907951FDCD1158F9719B8
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit

Hi,

One issue I'd like to add for the website.
Apache Brooklyn Applications catalog is not Search Engine Optimized :(
Searching "Apache Brooklyn tomcat" doesn't give results in Web search 
engines.

This could be related to some of my PRs  for docs [1]
I think hashtag urls are not well indexed.

[1] https://github.com/apache/incubator-brooklyn/pull/524

On 13/04/17 17:41, Duncan Godwin wrote:
> Hi Alex,
>
> I agree and had been thinking something similar, I put a PR in 
> yesterday to rework the blueprint section - 
> https://github.com/apache/brooklyn-docs/pull/168
>
> Many thanks
>
> Duncan
>
> On 13 April 2017 at 15:37, Alex Heneveld 
> <alex.heneveld@cloudsoftcorp.com 
> <mailto:alex.heneveld@cloudsoftcorp.com>> wrote:
>
>
>     Hi folks-
>
>     // RESEND with images embedded instead of attached PDF (which got
>     stripped - hopefully images don't!)
>
>     I've been hearing two categories of feedback from people who've
>     spent time on our website:  "I don't get it" and  "Sounds
>     complicated".
>
>     I think the time is right for us to fix this.  We can give a
>     clear, gentle experience, and we can tone down the academic ideas
>     in favour of real examples, which thanks to recent improvements
>     are pretty simple.  I'm thinking of a few changes:
>
>     * Expand and ground the landing page (currently it's all academic
>     theory words words words) -- I attach a mock-up of how this could
>     look in the attached (based on other sites)
>     * Rework the Getting Started example to be something using bash,
>     rather than a magic java entity
>     * Instead of YAML/Java blueprints, call it "Basic Blueprints"
>     "Advanced Blueprinting", make the "Basic Blueprints" section nice
>     simpler reference pages, with much of the content moved into
>     advanced (where the Java items might get buried further)
>
>     What do other people think?  Should we have a chat?  Say next Fri
>     4pm UK ?
>
>     Best
>     Alex
>
>
>
>
>
>

-- 
Valentin Aitken
Software Engineer
Cloudsoft Corporation Ltd.
www.cloudsoft.io


--------------272907951FDCD1158F9719B8--