topic Guidelines (Formerly Wiki) in Alfresco Archive

topic Guidelines (Formerly Wiki) in Alfresco Archive https://connect.hyland.com/t5/alfresco-archive/guidelines-formerly-wiki/m-p/157821#M111982 <HTML><HEAD></HEAD><BODY><H2 style="font-size: 16px; margin-bottom: 0.6em; font-weight: normal; padding-top: 0.5em; padding-bottom: 0.17em; color: black; border-bottom-width: 1px; border-bottom-style: solid; border-bottom-color: #aaaaaa; font-family: Arial, Helvetica, sans-serif;"><SPAN class="mw-headline"><LI-TOC indent="25" liststyle="disc" maxheadinglevel="6"></LI-TOC></SPAN></H2><H2 style="font-size: 16px; margin-bottom: 0.6em; font-weight: normal; padding-top: 0.5em; padding-bottom: 0.17em; color: black; border-bottom-width: 1px; border-bottom-style: solid; border-bottom-color: #aaaaaa; font-family: Arial, Helvetica, sans-serif;"><SPAN class="mw-headline">Purpose of Alfresco Collaborate</SPAN></H2><P style="margin-top: 0.4em; margin-bottom: 0.5em; color: #333333; font-family: Arial, Helvetica, sans-serif;">The Alfresco Collaborate space will be replacing the former wiki, which was used to coordinate our efforts around Alfresco Community Edition, and related projects. The <A class="external text" href="http://www.alfresco.com/products/activiti" style="color: #3366bb; padding: 0 13px 0 0; background-position: no-repeat no-repeat;" rel="nofollow noopener noreferrer">Activiti BPM platform</A>is managed <A class="external text" href="http://activiti.org/" rel="nofollow noopener noreferrer" style="color: #3366bb; padding: 0 13px 0 0; background-position: no-repeat no-repeat;">as a separate project with its own collaboration site</A>.</P><P style="margin-top: 0.4em; margin-bottom: 0.5em; color: #333333; font-family: Arial, Helvetica, sans-serif;">Each page in this section should help you participate in the open source community around Alfresco Community Edition. This is where the Alfresco product team documents how the project works, and allows the open source community to participate in our governance process.</P><P style="margin-top: 0.4em; margin-bottom: 0.5em; color: #333333; font-family: Arial, Helvetica, sans-serif;">Collaborate is not for documentation. Historically, we used the wiki for preliminary documentation of ongoing projects. This is initially convenient, but quickly becomes a maintenance problem resulting in hundreds of obsolete pages. Instead, these types of one-way communication should be blog posts which are clearly tied to a specific point in time. You can then suggest that the content of that blog post gets migrated to the <A class="external text" href="http://docs.alfresco.com/" style="color: #3366bb; padding: 0 13px 0 0; background-position: no-repeat no-repeat;" rel="nofollow noopener noreferrer">official documentation</A> by <A href="https://wiki.alfresco.com/wiki/Reporting_an_Issue" style="color: #2575ad;" title="Reporting an Issue" rel="nofollow noopener noreferrer">creating a DOCS issue</A>.</P><P style="margin-top: 0.4em; margin-bottom: 0.5em; color: #333333; font-family: Arial, Helvetica, sans-serif;">Instead of recreating documentation in this space, please link to the <A class="external text" href="http://docs.alfresco.com/" style="color: #3366bb; padding: 0 13px 0 0; background-position: no-repeat no-repeat;" rel="nofollow noopener noreferrer">official documentation on the topic</A>. If the documentation is not tied to a specific version of Alfresco, link to the Community Edition documentation where the URL will not change between versions.</P><H2 style="font-size: 16px; margin-bottom: 0.6em; font-weight: normal; padding-top: 0.5em; padding-bottom: 0.17em; color: black; border-bottom-width: 1px; border-bottom-style: solid; border-bottom-color: #aaaaaa; font-family: Arial, Helvetica, sans-serif;"><SPAN class="mw-headline">Making Corrections</SPAN></H2><P style="margin-top: 0.4em; margin-bottom: 0.5em; color: #333333; font-family: Arial, Helvetica, sans-serif;">If you see a problem with a specific page in the official documentation, you should fill out the feedback form at the bottom of the page. If you have feedback that does not apply to a single page, <A href="https://wiki.alfresco.com/wiki/Reporting_an_Issue" style="color: #2575ad;" title="Reporting an Issue" rel="nofollow noopener noreferrer">create an issue in the DOCS project</A>.</P><P style="margin-top: 0.4em; margin-bottom: 0.5em; color: #333333; font-family: Arial, Helvetica, sans-serif;">If you find something missing or incorrect, don't log a bug; register for an account, then start editing! No matter what your role in the Alfresco community—employee, customer, end-user, partner, developer—we want and need your help keeping the space up-to-date. <A class="external text" href="https://en.wikipedia.org/wiki/Wikipedia:Be_bold" rel="nofollow noopener noreferrer" style="color: #3366bb; padding: 0 16px 0 0; background-position: no-repeat no-repeat;">As Wikipedia encourages: be bold in updating pages!</A></P><P style="margin-top: 0.4em; margin-bottom: 0.5em; color: #333333; font-family: Arial, Helvetica, sans-serif;">In March 2015, we marked the whole wiki as "obsolete" (about one-thousand pages). We then unmarked the approximately 100 pages that are still relevant. If you come across a relevant page that has the obsolete notice, please remove the template tag and category. If you see an obsolete page frequently come up in a query, please link to the correct page in the official documentation. These obsolete pages can all be found in our <A _jive_internal="true" href="https://community.alfresco.com/community/ecm/content?filterID=contentstatus%5Bpublished%5D~category%5Barchive%5D" rel="nofollow noopener noreferrer">ECM Archive section</A>.</P><P style="margin-top: 0.4em; margin-bottom: 0.5em; color: #333333; font-family: Arial, Helvetica, sans-serif;">If you find yourself sharing a wiki page because it contains useful information that is not in the official documentation, please raise a DOCS issue and link to the wiki page.</P><P style="margin-top: 0.4em; margin-bottom: 0.5em; color: #333333; font-family: Arial, Helvetica, sans-serif;">Other ways you can help include:</P><UL><LI>Make sure all existing categories are linked in to category structure (see <A class="external text" href="https://wiki.alfresco.com/wiki/Special:UncategorizedCategories" style="color: #3366bb; padding: 0 16px 0 0; background-position: no-repeat no-repeat;" rel="nofollow noopener noreferrer">Uncategorized Categories</A>)</LI><LI>Make sure all pages have categories (see <A class="external text" href="https://wiki.alfresco.com/wiki/Special:UncategorizedPages" style="color: #3366bb; padding: 0 16px 0 0; background-position: no-repeat no-repeat;" rel="nofollow noopener noreferrer">Uncategorized Pages</A>)</LI><LI>Link to orphaned pages (see <A class="external text" href="https://wiki.alfresco.com/wiki/Special:LonelyPages" style="color: #3366bb; padding: 0 16px 0 0; background-position: no-repeat no-repeat;" rel="nofollow noopener noreferrer">Orphaned Pages</A>)</LI><LI>Updating the pages that have been marked as needing specific work (see <A href="https://wiki.alfresco.com/wiki/Category:Page_Needs_Work" style="color: #2575ad;" title="Category:Page Needs Work" rel="nofollow noopener noreferrer">Category<img id="smileytongue" class="emoticon emoticon-smileytongue" src="https://connect.hyland.com/i/smilies/16x16_smiley-tongue.png" alt="Smiley Tongue" title="Smiley Tongue" />age Needs Work</A>)</LI></UL><H2 style="font-size: 16px; margin-bottom: 0.6em; font-weight: normal; padding-top: 0.5em; padding-bottom: 0.17em; color: black; border-bottom-width: 1px; border-bottom-style: solid; border-bottom-color: #aaaaaa; font-family: Arial, Helvetica, sans-serif;"><SPAN class="mw-headline">Tips & Conventions</SPAN></H2><OL style="margin-top: 0.3em; margin-left: 3.2em; list-style-image: none; color: #333333; font-family: Arial, Helvetica, sans-serif;"><LI>Every category should be categorized. The only category that should not be categorized is <A href="https://wiki.alfresco.com/wiki/Category:ROOT" style="color: #2575ad;" title="Category:ROOT" rel="nofollow noopener noreferrer">Category:ROOT</A></LI><LI>Every page should be categorized.</LI><LI>Categories should live at the bottom of the page, below all other content. Use one line per category.</LI><LI>Let's keep the first level of categories below <A href="https://wiki.alfresco.com/wiki/Category:ROOT" style="color: #2575ad;" title="Category:ROOT" rel="nofollow noopener noreferrer">Category:ROOT</A> fairly succinct. In other words, don't add a new category to <A href="https://wiki.alfresco.com/wiki/Category:ROOT" style="color: #2575ad;" title="Category:ROOT" rel="nofollow noopener noreferrer">Category:ROOT</A> without a good reason.</LI><LI>Don't combine a release number with a topic. For example, don't categorize something as "3.0 JavaScript". Instead, categorize it as "3.0" and "JavaScript".</LI><LI>Do not categorize a wiki page as a "Community Contribution" solely because it is authored by someone in the community. Everything in the wiki is a community contribution. The community includes employees, partners, end-users, and everyone else.</LI></OL></BODY></HTML> Fri, 12 Aug 2016 11:58:06 GMT kgastaldo 2016-08-12T11:58:06Z Guidelines (Formerly Wiki) https://connect.hyland.com/t5/alfresco-archive/guidelines-formerly-wiki/m-p/157821#M111982 Purpose of Alfresco CollaborateThe Alfresco Collaborate space will be replacing the former wiki, which was used to coordinate our efforts around Alfresco Community Edition, and related projects. The Activiti BPM platformis managed as a separate project with its own collaboration site.Each page in th Fri, 12 Aug 2016 11:58:06 GMT https://connect.hyland.com/t5/alfresco-archive/guidelines-formerly-wiki/m-p/157821#M111982 kgastaldo 2016-08-12T11:58:06Z