1. 16 Oct, 2023 1 commit
  2. 12 Sep, 2023 1 commit
  3. 29 Aug, 2023 1 commit
  4. 28 Aug, 2023 1 commit
  5. 18 Aug, 2023 1 commit
  6. 17 Aug, 2023 1 commit
  7. 16 Aug, 2023 1 commit
  8. 15 Aug, 2023 1 commit
    • Greg Spencer's avatar
      Reorganize and clarify API doc generator (#132353) · 899a29f8
      Greg Spencer authored
      ## Description
      
      This cleans up a lot of issues with the API doc generation.
      
      Here are the main changes:
       - Rename `dartdoc.dart` to `create_api_docs.dart`
       - Move the bulk of the operations out of `dev/bots/docs.sh` into `create_api_docs.dart`.
       - Delete `dashing_postprocess.dart` and `java_and_objc.dart` and incorporate those operations into `create_api_docs.dart`.
       - Refactor the doc generation into more understandable classes
       - Bump the snippets tool version to 0.4.0 (the latest one)
       - Centralize the information gathering about the Flutter repo into the new `FlutterInformation` class.
       - Clean up the directory handling, and convert to using the `file` package for all file and directory paths.
       - Add an `--output` option to docs.sh that specifies the location of the output ZIP file containing the docs.
         - Defaults to placing the output in `dev/docs/api_docs.zip` (i.e. where the previous code generates the file).
       - Moved all document generation into a temporary folder that is removed once the documents are generated, to avoid VSCode and other IDEs trying to index the thousands of HTML and JS files in the docs output.
       - Updated pubspec dependencies.
      
      ## Tests
       - Added tests for doc generation.
      899a29f8