GUIDLINES FOR RELEASING REALITY FACTORY BUILDS
Posted: Sun Mar 25, 2007 11:49 am
Cummunity Releases of Reality Factory:
To keep things organized you have to follow these guidelines if you want to release a custom build of Reality Factory:
What you need to provide
1) Provide all necessary files to update from the latest official release (EXE, DLLs, GameEntityDataTypes.h etc.)
2) Provide documentation of new/changed features (html or txt format)
3) Provide source code changes as:
a) complete .h/.cpp files; add a description of the changes in the edit history at the top of each file;
mark changes with
e.g.
or
b) a list of code changes, including name of source file and line numbers of changes (referring to the latest official source code release)
Put the files of 1) and 2) in a zip file, put the source code changes in a separate zip file
Naming Conventions
Naming conventions for releases:
Community releases should be named in the following way:
Reality Factory CR Month/Day/Year
e.g.
Reality Factory CR 03/25/07
In CCommonData.cpp around line 718 change
to reflect the release version e.g.:
Naming conventions for zip files:
update & docs: RealityFactoryCR_MonthDayYear.zip
source code: RealityFactoryCRSource_MonthDayYear.zip
e.g.
RealityFactoryCR_032507.zip
RealityFactoryCRSource_032507.zip
How to inform the community
Start a new topic in the programming forum with the release name as its title.
Provide links to the zip files described above.
Provide any information about the release as you see fit (tips, tricks, potential bugs etc)
To keep things organized you have to follow these guidelines if you want to release a custom build of Reality Factory:
What you need to provide
1) Provide all necessary files to update from the latest official release (EXE, DLLs, GameEntityDataTypes.h etc.)
2) Provide documentation of new/changed features (html or txt format)
3) Provide source code changes as:
a) complete .h/.cpp files; add a description of the changes in the edit history at the top of each file;
mark changes with
Code: Select all
// changed AUTHOR MONTH/DAY/YEAR
// end change
Code: Select all
// changed QD 03/25/07
// end change
b) a list of code changes, including name of source file and line numbers of changes (referring to the latest official source code release)
Put the files of 1) and 2) in a zip file, put the source code changes in a separate zip file
Naming Conventions
Naming conventions for releases:
Community releases should be named in the following way:
Reality Factory CR Month/Day/Year
e.g.
Reality Factory CR 03/25/07
In CCommonData.cpp around line 718 change
Code: Select all
ReportError("--- Reality Factory 0.75C ---", false);
Code: Select all
ReportError("--- Reality Factory CR 03/25/07 ---", false);
update & docs: RealityFactoryCR_MonthDayYear.zip
source code: RealityFactoryCRSource_MonthDayYear.zip
e.g.
RealityFactoryCR_032507.zip
RealityFactoryCRSource_032507.zip
How to inform the community
Start a new topic in the programming forum with the release name as its title.
Provide links to the zip files described above.
Provide any information about the release as you see fit (tips, tricks, potential bugs etc)