Anthony Grasso website_and_docs last 3 years


 5 Collaborator
Mick Semb Wever , Eric Ramirez , Lorina Poland , Diogenese Topper , Chris Thornett

 3 Patch  3 Review
05b0eaecad5e40390352a4e182179a29ac784372, 1de171b910983628e1b7e19dbeac0a3bb09dbab0, 8178b6c23c7ea43178a7a140f4daa4deb38bd393 05b0eaecad5e40390352a4e182179a29ac784372, 217b35b4f26b5d71388926d09b526d53b8fecf01, 65033abc8747d060b45a958bd52be399a9cb9987

1de171b910983628e1b7e19dbeac0a3bb09dbab0 | Author: Anthony Grasso <anthony@thelastpickle.com>
 | 2022-04-02 15:41:01+11:00

    move and prepare files for content folder
    
    * Added logic to move generated website and in-tree docs to content folder
    * Added logic to remove hardcoded and missing domains from links
    * Added logging functionality
    
    patch by Anthony Grasso; reviewed by Michael Semb Wever for CASSANDRA-17374

8178b6c23c7ea43178a7a140f4daa4deb38bd393 | Author: Anthony Grasso <anthony@thelastpickle.com>
 | 2022-01-13 17:18:08+11:00

    Added tl;dr to README.md
    
     patch by Anthony Grasso; reviewed by Mick Semb Wever for CASSANDRA-16761

65033abc8747d060b45a958bd52be399a9cb9987 | Author: Diogenese Topper <diotopper@gmail.com>
 | 2021-12-23 19:14:21-08:00

    December blog post titled: "Configurable Storage Ports and Why We Need Them"
    
     patch by Chris Thornett, Diogenese Topper; reviewed by Anthony Grasso, Erick Ramirez for CASSANDRA-1722

217b35b4f26b5d71388926d09b526d53b8fecf01 | Author: mck <mck@apache.org>
 | 2021-12-23 23:42:12+01:00

    Just do `ant gen-asciidoc`, as all cassandra sources that have antora/asciidocs have gen-nodetool-docs.py and convert_yaml_to_adoc.py
    
     patch by Mick Semb Wever; reviewed by Anthony Grasso for CASSANDRA-16763

05b0eaecad5e40390352a4e182179a29ac784372 | Author: Lorina Poland <lorinapoland@gmail.com>
 | 2021-06-28 10:19:46-07:00

    Migrate documentation to AsciiDoc
    
    This commit sets up a new documentation structure and format:
    
    * The directory struture changes from a Sphinx project to an Antora module layout.
    * The formatting of the content changes from reStructuredText to AsciiDoc.
    
    The documentation must now be built and published with Antora. Initially only from the cassandra-website repository.
    
    This change was done to make maintaining versioned website documentation easier. As Antora is designed to generate versioned documentation.
    
    The old directory structure was:
    
    <ROOT>
      - doc/
        - cql3/
          - CQL.css
          - CQL.textile
        - source/
          - _static/
          - _templates/
          - _theme/
          - _util/
          - <other directory sections>/
          - conf.py
          - index.rst
          - <other *.rst pages>
        - make.bat
        - Makefile
        - README.md
        - SASI.md
        - <*.spec files>
        - <generation scripts>
    
    The new directory structure organises the documentation into modules:
    
    <ROOT>
      - doc/
        - cql3
        - modules/
          - cassandra/
            - assets/
            - examples/
            - pages/
            - partials/
            - nav.adoc
          - ROOT/
            - pages/
            - nav.adoc
        - scripts/
        - antora.yaml
        - README.md
        - SASI.md
    
     patch by Lorina Poland, Anthony Grasso; reviewed by Anthony Grasso, Mick Semb Wever for CASSANDRA-16763
    
    Co-authored-by: Anthony Grasso <anthony@thelastpickle.com>