Community Coding Standards

Document created by resplin Employee on Jun 6, 2015Last modified by kgastaldo on Nov 22, 2017
Version 2Show Document
  • View in full screen mode

Obsolete Pages{{Obsolete}}

The official documentation is at: http://docs.alfresco.com



DevelopingCommunity

 

Scope

 

Alfresco does not mandate coding standards to third-party developers. However, we recognize that having consistent standards across the community will help with collaboration and code re-use. That is why we publish our internal coding standards. This page is for collaboration around community standards for Alfresco add-ons and extensions.

These are very lose guidelines, and each project is free to establish their own coding standards.

 

Project Standards

 

Best Practices and Examples

 

Add to this list pointers at specific files that are good examples of that file type. Also include well managed project layouts / packages. List the reasons why it is a good example.

 

  • Java: org.alfresco.repo.model.filefolder.FileFolderServiceImpl.java (Alfresco Enterprise 4)
    • Comment block at the top of the file with crystal clear copyright and licensing notices.
    • Imports are ordered precisely - standard JDK imports first (in alphabetical order), then non-JDK imports (including org.alfresco, also in alphabetical order).
    • Method order is:Constructor(s), Spring setters, Spring init method, 'Vanilla' methods
    • JavaDoc comments on all methods except for Spring setters.
    • Use of whitespace.

IDE Specific Instructions

 

This is a good place to link to publish instructions and plugins for configuring your preferred IDE for Alfresco development.

 

Eclipse

 

  • Properties Editor: Helps with saving the properties files in correct format for non-ascii-characters

Attachments

    Outcomes