Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
Column

As the release date approaches, general work on features should stop and work should focus only on fixing existing bugs and other release-specific preparations. This requires coordination; this page describes the tasks that should be carried out for and during Bug Parade.

Create Release-related JIRAs

The real work of creating a release is managed through a number of Blocker JIRA issues. These JIRAs must be created for each release during Bug Parade, and any necessary changes to the code must be committed against them.

Column
width40%
Panel
borderColor#566b30
bgColor#fff
titleBGColor#D3E3C4
borderStylesolid
titleBug Parade
Table of Contents
maxLevel4
minLevel3

Issue Title

Issue Description

Code cleanup for release x.x

Clean up comments, ensure public APIs are fully commented and JSLint new javascript files.
Note that this issue should only be in force before Code Freeze. Commits that alter actual code should not be permitted during Code Freeze.

Check licenses and copyrights

Ensure all javascript files have a license and copyright. Also make sure thirdparty code is compatibly licensed and a license file is included in the same directory as the code.

Update and expand on unit test coverage

Increase unit test coverage and ensure that all tests are passing.

Update all version numbers for the release

All references to the version number must be updated to the new version number. This includes: package.json, all *.js files, "fluid.version" in Fluid.js

Comment any "unsupported" functions/variables/etc

Anything in our code that is "unsupported" (i.e. not meant for public use despite the fact that technically it is public) needs to be indicated as such in the comments in the code. This covers

  • public free functions i.e. functions in the public namespace, such as fluid.inlineEdit.foo()
  • methods and instance variables on an object returned by a creator function
  • options defined in a defaults block or otherwise processed in the code but not for public use
  • return values
    Please a comment in the code mentioning that the method/function/option/argument/return value is unsupported, and perhaps an explanation of why. Anything unsupported will not be publicly documented.

Update the README.txt and ReleaseNotes.txt files

Be sure to update the version number, the zip file names (which include the version number), the "What's New" section with a list of features of the release, folder hierarchy if it has changed at all (e.g. new sample-code folders added), the list of supported browsers if it has changed, and the "Known Issues" section with highlights of the known issues.

Turn off debug mode

Update fluid.fail() to throw an error, turn off debug mode for the renderer, etc.

screen source files for DOS line ending
This should be handled by git

Run source tree through an utility like dos2unix to normalize line endings for Unix. See note below for more information.

Removing DOS CR/LF

For Ubuntu using fromdos command:

...

The Fluid community should be relied on for testing assistance. The best way to obtain testing help is through the fluid-work mailing list and the #fluid-work irc channel:matrix.org.

back to top