[OOTB-hive] Wiki updates

Martin Cosgrave martin at ocretail.com
Fri May 22 22:16:35 BST 2015 

Yes, searchability is a perfectly good word. But when you use the word 
'examples' you prove my point. An example is a story about 
functionality, it isn't documentation as far as I understand the term.

For example where can I find a list of all extension points I can 
override functionality in Alfresco with? If your answer is 'here is an 
example that lists the extension points in its text' then that is not 
documentation to me. If it requires 'searchability' rather than 
'structure' to find what I'm looking for, it also is in all probability 
not documentation. The actual answer is 'look in this xml file'. If the 
xml file was listed somewhere with that advice, even that would be 
better documentation than what we have.


On 22/05/15 23:12, Tahir Malik wrote:
> The main problem with the docs is searchability I'm not sure if that 
> even is a word. But if you eventually find the article it has examples 
> the wiki doesn't have.
>
> Best regards,
>
> Tahir Shazad Malik
> Contezza
> ------------------------------------------------------------------------
> From: Martin Cosgrave <mailto:martin at ocretail.com>
> Sent: ‎22/‎05/‎2015 23:10
> To: Tahir Malik <mailto:tahir.malik at contezza.nl>; Peter Monks 
> <mailto:peter.monks at alfresco.com>; Mark Stang 
> <mailto:markjstang at gmail.com>
> Cc: ootb-hive at xtreamlab.net <mailto:ootb-hive at xtreamlab.net>
> Subject: Re: [OOTB-hive] Wiki updates
>
> I don't know that I can agree with that, they still just seem to be 
> stories whenever I try to find anything.
>
> On 22/05/15 23:09, Tahir Malik wrote:
>> Yeah but I have to say now a days the Alfresco docs is far superior 
>> in many articles. So instead we should link to the docs.
>>
>> Sure that doesn't apply to all articles. But I have to hand in that 
>> Alfresco did improve the docs a lot 😊.
>>
>> Best regards,
>>
>> Tahir Shazad Malik
>> Contezza
>> ------------------------------------------------------------------------
>> From: Martin Cosgrave <mailto:martin at ocretail.com>
>> Sent: ‎22/‎05/‎2015 23:07
>> To: Peter Monks <mailto:peter.monks at alfresco.com>; Mark Stang 
>> <mailto:markjstang at gmail.com>
>> Cc: ootb-hive at xtreamlab.net <mailto:ootb-hive at xtreamlab.net>
>> Subject: Re: [OOTB-hive] Wiki updates
>>
>> It's much worse now for newcomers, they are being definitively told 
>> that good information is bad. I don't know how you can think that 
>> that is an easier path for a newbie. It really is vandalism in my 
>> opinion.
>>
>> On 22/05/15 22:00, Peter Monks wrote:
>>> G’day Mark,
>>>
>>> The best solution is what Richard said:
>>>
>>>     “clear that tag on good pages or mark the ones that need work
>>>     but should be kept.”
>>>
>>>
>>> This is an exercise virtually everyone in the community can 
>>> participate in, as it’s both low effort / expertise (was a page 
>>> useful? remove the tag!) and high value - over the long run it will 
>>> allow us (the inclusive “us”, not the divisive “us”…) to remove 
>>> pages that retained the tag - a kind of “Sieve of Esplinosthenes” if 
>>> you will.  ;-)
>>>
>>> And while clearly outdated pages are obvious to longstanding members 
>>> of the community, I suspect they were (prior to the tag) a 
>>> significant source of confusion for newcomers who don’t know what 
>>> they don’t know (yet).
>>>
>>> Cheers,
>>> Peter
>>>
>>>
>>>
>>>> On 2015-05-22, at 12:33 PM, Mark Stang <markjstang at gmail.com 
>>>> <mailto:markjstang at gmail.com>> wrote:
>>>>
>>>> I was a bit shocked to see all the wiki pages marked as Obsolete.  
>>>> I asked an "Alfresco Insider" who informed me that:
>>>>
>>>> Richard marked every wiki page obsolete. He is hoping people will 
>>>> either clear that tag on good pages or mark the ones that need work 
>>>> but should be kept.
>>>>
>>>> I don't know if the CMIS stuff was moved to docs or not.
>>>>
>>>> Some of it is obviously out-of-date and has been for awhile. The 
>>>> rest is still current AFAIK.  So, going forward, I am ignoring the 
>>>> warning.
>>>>
>>>> I am not sure what the best solution would be.
>>>>
>>>> regards,
>>>>
>>>> Mark
>>>>
>>>> On Fri, May 22, 2015 at 1:24 PM, Martin Cosgrave 
>>>> <martin at ocretail.com <mailto:martin at ocretail.com>> wrote:
>>>>
>>>>     I've read the whole thread, except I started a few messages in,
>>>>     and the last thing I've done is to come back to the first post
>>>>     and actually look at the chart in question. I actually don't
>>>>     have a problem with it, as has been said you expect marketing
>>>>     types to do that, but at least there at the bottom is a clear
>>>>     download link to CE. I couldn't be more pleased that the two
>>>>     are presented together. I'm sure that everyone must have had
>>>>     experiences similar to mine of knowing that a product has an
>>>>     open source version, and struggling to find any mention of it
>>>>     until you find the tiny 'Community' link in dark brown on black
>>>>     at the bottom of the page.
>>>>
>>>>     There is certainly no harm in creating a counterpoint page, it
>>>>     could be quite tongue in cheek, maybe we can put a lot of red
>>>>     X's next to EE :-P
>>>>
>>>>     A quick side note about Honeycomb, there really is a lot of
>>>>     good stuff you guys could contribute, especially if you know
>>>>     puppet or a similar devops tool, but if not even just building
>>>>     it and commenting on or modifying the configurations we have
>>>>     chosen would be really useful. There are only two of us
>>>>     involved in it right now and I've been a bit busy starting a
>>>>     job and moving city in the last month or so. I just noticed it
>>>>     was mentioned a couple of times in the thread so I guess there
>>>>     is some value there and mindshare even if nobody's stepping
>>>>     forward.
>>>>
>>>>     It's a shame the thread spiralled out of control at the end
>>>>     there. At the beginning it was really constructive and it's
>>>>     definitely worth going back and looking over those bits :-) .
>>>>     However it's obvious there are strong feelings on both sides.
>>>>     Personally I feel very strongly that the vandalism to the wiki
>>>>     pages which marks all the useful community-oriented
>>>>     documentation as obsolete be reverted.
>>>>
>>>>     I thought Ainga's point that we could be more marketing
>>>>     oriented as bees was spot on. Perhaps he could step up to the
>>>>     mark on that one, as a bee who is also a CEO?
>>>>
>>>>     I like very much Heiko's idea for a common model registry,
>>>>     especially if he has some models to donate to it. What a great
>>>>     thing for OOTB to have, especially as the model system confuses
>>>>     newcomers to the product, both for CE and EE I am sure.
>>>>
>>>>     I really wish we could have a documentation project. To my mind
>>>>     there has never been any decent documentation for alfresco, and
>>>>     Jeff's noble efforts, which were amazing, were nonetheless
>>>>     stories about how to do certain tasks, and stories do not make
>>>>     decent documentation. I suppose this is a common conflict for
>>>>     open source companies trying to sell consultancy, or to build a
>>>>     partner ecosystem, if the documentation is too good then there
>>>>     will be no need for consultants.
>>>>
>>>>     Anyway, great thread really, I actually think that the getting
>>>>     out of control bit was probably a misunderstanding, at least as
>>>>     far as I can tell re-reading the messages. It's great to know
>>>>     that so many people care about the Order. Hopefully we can see
>>>>     a bit more active participation as a result.
>>>>
>>>>     Have a great weekend
>>>>
>>>>     Martin
>>>>
>>>>
>>>>
>>>>
>>>>     On 21/05/15 09:59, Andreas Steffan wrote:
>>>>>     Hallo everybody,
>>>>>
>>>>>     I can't help myself, but the CE looks pretty bad at
>>>>>     https://www.alfresco.com/products/community-vs-alfresco-one to
>>>>>     me (red all over the place).
>>>>>
>>>>>     Seriously: Imagine you are a somewhat clueless prospect on
>>>>>     that page which reads " Ready to get started? Download the
>>>>>     edition that is right for you.".
>>>>>
>>>>>     Would you want to give the CE a try?
>>>>>
>>>>>     regards
>>>>>     Andreas
>>>>>     -- 
>>>>>     Andreas Steffan
>>>>>
>>>>>     Achter Billing 14
>>>>>     22399 Hamburg
>>>>>     Germany
>>>>>
>>>>>     skype: contentreich
>>>>>     M:+49 1793903615  <tel:%2B49%201793903615>
>>>>>     T:+49 40 23943542  <tel:%2B49%2040%2023943542>
>>>>>     F:+49 40 23943542  <tel:%2B49%2040%2023943542>
>>>>>
>>>>>     http://www.contentreich.de  <http://www.contentreich.de/>
>>>>>
>>>>>     Contentreich : Alfresco ECM, Clojure, Groovy und WordPress - aus Spaß und für Geld
>>>>>
>>>>>
>>>>>     _______________________________________________
>>>>>     OOTB-hive mailing list
>>>>>     OOTB-hive at xtreamlab.net  <mailto:OOTB-hive at xtreamlab.net>
>>>>>     http://www.xtreamlab.net/mailman/listinfo/ootb-hive
>>>>
>>>>
>>>>     _______________________________________________
>>>>     OOTB-hive mailing list
>>>>     OOTB-hive at xtreamlab.net <mailto:OOTB-hive at xtreamlab.net>
>>>>     http://www.xtreamlab.net/mailman/listinfo/ootb-hive
>>>>
>>>>
>>>> _______________________________________________
>>>> OOTB-hive mailing list
>>>> OOTB-hive at xtreamlab.net <mailto:OOTB-hive at xtreamlab.net>
>>>> http://www.xtreamlab.net/mailman/listinfo/ootb-hive
>>>
>>
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.xtreamlab.net/pipermail/ootb-hive/attachments/20150522/70b2622e/attachment-0001.html>

More information about the OOTB-hive mailing list