wiki:Documentation/Outdated

Version 14 (modified by ascheibe, 4 years ago) (diff)

--

The following pages may need an update:

Page Task / Problem Owner
Documentation/Howto/DefineCustomProblems use programmable problem/n-queens ascheibe
Documentation/Howto/OptimizeAnyLogicModels reflect changes to ExternalEvaluationProblem abeham
Documentation/Howto/OptimizeExternalApplications reflect changes to ExternalEvaluationProblem, also cut down in length, maybe merge with above abeham
Documentation/Howto/UseHiveForOptimization mentions HL 3.3.6 - any updates? ascheibe
Documentation/Howto/Implement Custom Problems? Does not add that much value ?
Documentation/Howto/SetupHiveSlave Should include a download link? ?
Documentation/DevelopmentCenter/ExternalLibraries mentions 3.3.10, updates? ?
Documentation/DevelopmentCenter/ArchitectureParameterTypes? not complete, ch130!? ?
Documentation/DevelopmentCenter/VSCodeSnippets Still VS 2010 ?
Documentation/DevelopmentCenter/ImplementAnEvaluator More reasonable example, e.g. Knapsack without penalty parameter ?

Discussion

  • Documentation should be less of a loose collection of individual articles with an example here and an example there
    • Concrete examples are great though, definitely keep them
  • We should add some structure, by defining use cases and supporting those with specific documentation
    • Like "This is how you do XYZ", for all the XYZ that we can think of and then have concrete examples for XYZ
  • We need short(!) reference documentation on common topics like parameters and parameter lookup, backwards compatibility, cloning, operator instrumentation, etc.