Hi Tez dev@, I recognize that this thread is running in parallel with a dev@ discussion regarding concerns about and steps to prevent Tez from being moved to the Attic… but I thought I’d send it none-the-less.
I wanted to start a thread regarding reorganizing/overhauling the presentation of Tez website and wiki documentation. <gripe> One of the things which turned me away from Tez initially was the sparse documentation. I found myself piecing together breadcrumbs of information before I was able to do anything remotely useful. This is not particularly welcoming to new/prospective users. </gripe> I think that something can be done about the above and I would like this thread to focus on some proposed improvements which would * lower the barrier to new prospective Tez users * assist moderate to advanced Tez users in contributing more documentation. * provide the Tez project with a long-overdue facelift and public-facing image. Some areas for consideration/ideas * let’s gather suggestions for a content management framework which facilitates a smooth authoring and publication workflow (for example I’ve used https://jekyllrb.com/ with some success in the past). * I would suggest that we deprecate the wiki ( https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=30758956) and migrate content to the new website likely under a technical documentation navigation. * I suggest that we archive all content relating to legacy Tez versions. There’s quite a lot of content peppered throughout the wiki which interrupts smooth reading. * we need to produce a simple getting started guide which focuses on intuitive examples and doesn’t burden the user with installation and environments blockers before they can see what Tez does. * we should archive all broken resources on the website e.g. users group I hope the above will spur some conversation. I will also state that I am willing to roll my sleeves up and make the above happen. Any input from dev@ is really appreciated. My goal would be to create a plan and then gradually hack away at it. Thanks lewismc
