Community Coding Standards

Document created by resplin Employee on Jun 6, 2015
Version 1Show 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