DOC-624 | Add ArangoML self-managed content

[nerpaula]

Description

Added ArangoML on-prem content.

[arangodb-docs-automation[bot]]

Deploy Preview Available Via
https://deploy-preview-419--docs-hugo.netlify.app

[cw00dw0rd]

@nerpaula We will try and consolidate the naming related to ArangoGraphML as right now we have about 6 different names for it depending on where you look across ArangoDB. Going forward, we would like to refer to it as ArangoGraphML and then if needed ArangoGraphML self-managed.

I think this can simplify the above-discussed issue of having two separate pages that have essentially the same information. My proposed layout change would have the existing GraphML page (changed to ArangoGraphML) and then a deploy page that has the current ArangoGraphML vs GraphML self-managed blurb, and then we can have a getting started section that has the existing walkthrough information, tutorials, etc.

Additionally, starting with the trial, we will no longer have ArangoGraph Notebooks that exist without ML. You will only be able to create a notebook server with ML services enabled. So, we could move the ArangoGraph notebook section into the ArangoGraphML > Getting Started section. The proposed change would look something like this:

• ArangoGraphML
  • Deploy (single page with or with sub-pages for self-managed / ArangoGraph)
  • Getting Started (maybe a better name for the main page/subpage)
  • Getting Started
  • ArangoGraph Notebooks

Additionally, based on some above conversation, I would agree that it might make sense to have a specific page just for the specifications, as that is a major part of the services and might clutter the rest of the content.

WDYT?

[nerpaula]

@cw00dw0rd the proposed layout change sounds good! Let's move forward with this. However, I would leave out the Notebooks page for now and make the required changes in another PR once the change is ready to go in production (there's a separate ticket for this).

[nerpaula]

@cw00dw0rd @geenen124 @aMahanna the content is now reorganized, see https://deploy-preview-419--docs-hugo.netlify.app/devel/data-science/arangographml/ and sub-pages.

What changed:

• the index page, graphml, has been renamed to arangographml and contains only general information
• created a new page called deploy that describes the difference between managed service and self-managed and includes initial setup instructions.
• slightly adjusted the existing Getting Started page so that it includes the extra steps required for the self-managed solution. Used tabs to indicate the differences. Maybe rename it to something like "How to train your model"?
• removed the self-managed example for now. I think it can potentially turn into a new page, maybe called "End-to-end example" but first it needs to be adjusted with step-by-step instructions, expected output and no placeholders. @aMahanna would be great if you can help out with this.

As a result, we can have something along:

• ArangoGraphML (general info)
  • Deploy/Setup
  • How to train your model
  • End-to-end example (the adjusted version of example based on OPEN_INTELLIGENCE_ANGOLA dataset)

Happy to rename any of the pages or sections.