Skip to content

Aura Fundamentals #369

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open

Aura Fundamentals #369

wants to merge 6 commits into from

Conversation

adam-cowley
Copy link
Contributor

Supersedes #302

martinohanlon and others added 3 commits July 29, 2025 10:21
@martinohanlon @adam-cowley
@MacondoExpress @RafalSkolasinski @ioilmio @JMHReif @Copilot @Liam-Doodson @irina-loghin-neo4j
rebase aura-fundamentals (#379)
a61fb81 
* How we teach (#325)

* Disable cache when db credentials are needed

* wip

* remove rogue content

* Rebase how-we-teach (#370)

* add line break in admonition

* Minor fixes (#324)

* Typo

* Fix typo

* Auto committing transactions

* Nodes 2025 CFP (#323)

* Disable cache when db credentials are needed

* cfp link in emails

* 1.29.10

* update references from app-python to drivers-python

* migrate app-spring-data to codespace (#328)

* graphql-basics - changes for GraphQL7 (#327)

* text changes for graphql7

* updated images

* add query / cypher comparison

Co-authored-by: MacondoExpress <[email protected]>

* put example in collapse

* fix url

* replace image

---------

Co-authored-by: MacondoExpress <[email protected]>

* fix minor typos (#329)

* Minor fixes (#326)

* removed test to check that a constraint exists

* added test to the solutio

* 1.29.11

* added summary.adoc

* reinstate adding the driver lesson to app-python

* Update lesson.adoc (#330)

remove repeated "would be"

* driver-java course (#335)

* in progress update

* In progress updates

* in progress update

* todo for Jennifer

* Update drivers-java course lessons on temporal, spatial, and errors

* in progress updates

* tidy course description

* add banner

* Minor setup changes

---------

Co-authored-by: Jennifer Reif <[email protected]>

* Introduction to Graph Databases Workshop (#333)

* in progress update

* in progress updates

* in progress update

* in progress updates

* add relationship type to graph

* fix slide

* prep for release

* copy neo4j-fundamentals content

* 1.30.0

* driver-java - fix minor issues (#336)

* in progress update

* In progress updates

* in progress update

* todo for Jennifer

* Update drivers-java course lessons on temporal, spatial, and errors

* in progress updates

* tidy course description

* add banner

* Minor setup changes

* fix branch

* fix quiz question

* add next buttons

* add next to slides

---------

Co-authored-by: Jennifer Reif <[email protected]>

* workshop-fundamentals - post golive fixes (#337)

* fix image url

* fix source blockl

* fix cypher

* typo

* fix cypher

* added challenge

* 1.30.1

* fix order

* 1.30.2

* fix order

* 1.30.3

* Fixes to drivers-java & workshop-fundamentals (#339)

* feedback from JMHReif

* make courses active

* workshop-importing (#338)

* in progress updates

* in progress updates

* banners

* make course darft

* remove optional

* make course active

* 1.31.0

* remove file to fix error

* 1.31.1

* fix usecase

* 1.31.2

* GraphRAG landing page (#341)

* first pass graphrag landing page

* add additional courses

* 1.31.3

* s/pythontypscript

* Updates for typos and things missed (#340)

* Updates for typos and things missed

* Update 1-driver/2-execute-query lesson for method name in lesson summary

* Remove odd async line in driver lifecycle lesson

* Add async reference to production module lesson

* Remove unnecessary driver.close()

This is only necessary when dealing with transaction functions. The `executableQuery()` method closes resources itself.

* Update mismatch query param in 1-execute-query.adoc

* Update mismatch query param in 2-access-results.adoc

* readd driver.close

* bolt to neo4j

---------

Co-authored-by: Martin O'Hanlon <[email protected]>

* Data importer product updates (#342)

* data importer product updates

* typo

* typo

* GraphQL product updates (#343)

* graph ql product updates

* typo

Co-authored-by: Copilot <[email protected]>

* typo

Co-authored-by: Copilot <[email protected]>

* missing .

* missing ,

---------

Co-authored-by: Copilot <[email protected]>

* GDS product updates (#344)

* gds product updates

* typo

Co-authored-by: Copilot <[email protected]>

* grammar

Co-authored-by: Copilot <[email protected]>

---------

Co-authored-by: Copilot <[email protected]>

* 1.31.4

* Docker updates & Devcontainer config (#345)

* resolved issues with docker-compose

* added devcontainer config

* updated README

* README typo

* added db sync

* remove comment

* remove obsolete versions

* update healthcheck command, update hostname in sync container, hardcode username as neo4j

* add recommended extensions

---------

Co-authored-by: Adam Cowley <[email protected]>

* Add object mapping driver feature to drivers-java course (#346)

* Add object mapping driver feature to drivers-java course

* Update asciidoc/courses/drivers-java/modules/1-driver/lessons/4-object-mapping/lesson.adoc

Co-authored-by: Martin O'Hanlon <[email protected]>

* Update asciidoc/courses/drivers-java/modules/1-driver/lessons/4-object-mapping/lesson.adoc

Co-authored-by: Martin O'Hanlon <[email protected]>

* Update asciidoc/courses/drivers-java/modules/1-driver/lessons/4-object-mapping/lesson.adoc

Co-authored-by: Martin O'Hanlon <[email protected]>

* Update asciidoc/courses/drivers-java/modules/1-driver/lessons/4-object-mapping/lesson.adoc

Co-authored-by: Martin O'Hanlon <[email protected]>

* Update asciidoc/courses/drivers-java/modules/1-driver/lessons/4-object-mapping/lesson.adoc

Co-authored-by: Martin O'Hanlon <[email protected]>

* Update asciidoc/courses/drivers-java/modules/1-driver/lessons/4-object-mapping/lesson.adoc

Co-authored-by: Martin O'Hanlon <[email protected]>

* Incorporate review comments

---------

Co-authored-by: Martin O'Hanlon <[email protected]>

* Support multiple database providers (#348)

* add database-provider, vector-optimised and graph-analytics-plugin attributes

* fix english spelling

* genai-fundamentals (#349)

* structure

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* next steps

* walk through updates

* walkthrough updates

* added banners

* updated branch

* set course active

* remove course (#350)

* 1.32.0

* updated key points (#352)

* 1.32.1

* genai-fundamentals updates (#351)

* typo

* reword

* number diagram

* definition

* added graph diagram

* key points

* grammar

* typo

* accuracy fix

* genai-integration-langchain (#353)

* structure

* in progress updates

* fix settings

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* in progress updates

* summary

* banners

* 1.33.0

* Genai courses golive (#355)

* course categories and status

* replace links to llm-fundamentals

* replace branch

* fix tag

* replace links to llm-fundamentals

* 1.33.1

* rename sandbox attributes to instance (#357)

* 1.33.2

* 1.33.3

* revert provider to sandbox for modeling-fundamentals

* 1.33.4

* Building your own MCP tools (#356)

* Update leveloffset on all question includes (#358)

* update leveloffset=+2

* add .quiz header to CYU

* llm review

* 1.33.5

* genai-mcp-neo4j-tool - updates post testing (#362)

* minor grammar updates

* remove aura

* added local install instructions

* ordered answers

* move start server to tip

* changed to multiple choice

* Open chatbot on lesson load (#361)

* enable chatbot to be open on lesson load

* open chatbot on 1-what-is-mcp/3-installing-servers

* notes in uv

* Add llms.txt (#363)

* create sample llms.txt

* add review rules

* Update outdated links in graphql course (#364)

* Update outdated links in graphql course

* Update more outdated links

* Remove toolbox reference from module where it is not discussed

* 1.33.6

* Updates for slides (#360)

* remove optional activity

* added images

* added slides

* added course complete msg

* genai-mcp-tools-neo4j go live (#365)

* added categories

* minor typo

* 1.33.7

* fix mdc link

* add workshops to README

* run build in parallel

* add genai-mcp-neo4j-tools/ad.adoc

* add pr templates

* remove empty header

* Add a new conversation lesson type to genai-mcp-neo4j-tools (#367)

* run build in parallel

* add conversation lesson, create llms.txt for the module

* typo (#366)

* lint

* 1.33.8

* 1.33.9

---------

Co-authored-by: Adam Cowley <[email protected]>
Co-authored-by: Adam Cowley <[email protected]>
Co-authored-by: MacondoExpress <[email protected]>
Co-authored-by: Rafal Skolasinski <[email protected]>
Co-authored-by: ioilmio <[email protected]>
Co-authored-by: Jennifer Reif <[email protected]>
Co-authored-by: Copilot <[email protected]>
Co-authored-by: Liam-Doodson <[email protected]>

* modules 1 and 2

---------

Co-authored-by: Martin O'Hanlon <[email protected]>
Co-authored-by: Martin O'Hanlon <[email protected]>
Co-authored-by: MacondoExpress <[email protected]>
Co-authored-by: Rafal Skolasinski <[email protected]>
Co-authored-by: ioilmio <[email protected]>
Co-authored-by: Jennifer Reif <[email protected]>
Co-authored-by: Copilot <[email protected]>
Co-authored-by: Liam-Doodson <[email protected]>

* 1.33.10

* clean pull request templates

* Fix genai-fundamentals question (#371)

* fix question

* use parameter for api key

---------

Co-authored-by: Adam Cowley <[email protected]>

* Minor workshop updates (#372)

* use parameter for api key

* split into columns

* split across slide

* typo

---------

Co-authored-by: Adam Cowley <[email protected]>

* Added additional reset scripts and instructions (#373)

* added genai-fundamentals reset scripts

* add create index instructions

* added detail on how the vector index is created

* added additional reset scripts

* 1.33.11

* Michael Sarah bi-directional fixes (#374)

* make titles discrete

* docker compose updates

* michael sarah diagram, and content update for workshop and neo4j fundamentals

---------

Co-authored-by: Martin O'Hanlon <[email protected]>

* 1.33.12

* remove nodes 2025 from emails

* 1.33.13

* add instructions for symlinking certifications

* Move MCP setup instructions back to lesson (#375)

* add instructions for symlinking certifications

* move instructions into course - fixes credentials being pre-rendered

* Teams emails (#377)

* add user joined team email

* add user notifed team email

* updated what is neo4j video (#376)

* 1.33.14

* 1.33.15

* remove ' '

---------

Co-authored-by: Adam Cowley <[email protected]>
Co-authored-by: MacondoExpress <[email protected]>
Co-authored-by: Rafal Skolasinski <[email protected]>
Co-authored-by: ioilmio <[email protected]>
Co-authored-by: Jennifer Reif <[email protected]>
Co-authored-by: Copilot <[email protected]>
Co-authored-by: Liam-Doodson <[email protected]>
Co-authored-by: Adam Cowley <[email protected]>
Co-authored-by: irina-loghin-neo4j <[email protected]>
@irina-loghin-neo4j
new course structure, removed unwanted phrases
1caeaa3
@adam-cowley
Merge branch 'main' into aura-fundamentals-rebase
5551d8c
martinohanlon
martinohanlon reviewed Aug 7, 2025
View reviewed changes
Copy link
Contributor

@martinohanlon martinohanlon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The majority of my comments relate to style, simplifying language, and providing clear instruction.

The lessons need meta data added (type, order, etc).

Images should include a description of the image to support accessibility.

asciidoc/courses/aura-fundamentals/modules/1-introduction/lessons/1-about/lesson.adoc Outdated
@@ -0,0 +1,36 @@
= About Aura
:table-caption!:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I dont know what this is

asciidoc/courses/aura-fundamentals/modules/1-introduction/lessons/1-about/lesson.adoc
@@ -0,0 +1,36 @@
= About Aura
:table-caption!:

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lesson should have associated meta data, e.g.

:order: x
:type: lesson/video/quiz/challenge

...idoc/courses/aura-fundamentals/modules/1-introduction/lessons/3-understand-costs/lesson.adoc
= Understanding costs
:table-caption!:

Now that you know how to create and manage Aura instances, you might be wondering about the costs involved and how they compare to managing your own Neo4j infrastructure.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does the learner know how to create and manage instances? I dont think this has been covered yet.

Is this sentence too "conversational"? I would avoid leading words like "Now", and suppositions such as "you might be wondering".

...idoc/courses/aura-fundamentals/modules/1-introduction/lessons/3-understand-costs/lesson.adoc

The real comparison requires looking at everything that's included:

.Complete comparison
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this create a maintenance challenge? How will changing costs be updated? Are we better to lik out to documentation?!

...idoc/courses/aura-fundamentals/modules/1-introduction/lessons/3-understand-costs/lesson.adoc Outdated
====
Neo4j Community edition requires that you abide by the GPL v3 license.

The Enterprise Edition software does have RBAC but the Aura Professional tier is limited in that respect.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Have we defined what RBAC is? Should this be Role Based Access Control (RBAC).

asciidoc/courses/aura-fundamentals/modules/3-services-tools/lessons/4-dashboard/lesson.adoc
Filters allow users to dynamically change what data is displayed without modifying queries.

Add a filter to your dashboard:

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think there is a step missing here about clicking the Add Filter button.

...rses/aura-fundamentals/modules/3-services-tools/lessons/4-dashboard/questions/1-purpose.adoc

Which of the following statements best describes the purpose of Aura's integrated dashboard tool?

* [ ] The integrated dashboard tool aims at business users who don't understand Cypher syntax but know the underlying data model.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would be cautious about using roles. Why wouldnt business users understand Cypher?

...rses/aura-fundamentals/modules/3-services-tools/lessons/4-dashboard/questions/1-purpose.adoc

* [ ] The integrated dashboard tool aims at business users who don't understand Cypher syntax but know the underlying data model.
* [x] The integrated dashboard tool aims to lower the time-to-value by bridging the gap between learning Neo4j technology and building full applications.
* [ ] The integrated dashboard tool aims at power users (developers, DBAs) who are willing to learn Cypher syntax as their primary database interaction method.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again, why isnt Dashboards a good tool for Developers? It is if you want to see information regularly and get reports.

asciidoc/courses/aura-fundamentals/modules/3-services-tools/module.adoc
@@ -0,0 +1,10 @@
= Tools

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:order: 3

asciidoc/courses/aura-fundamentals/modules/3-services-tools/module.adoc Outdated
@@ -0,0 +1,10 @@
= Tools

In this module you interact with the tools providing in the console. You **import** data. You **query** data. You **explore** data. You **dashboard** data. Wait ... erm ... you **build a dashboard on top of your data**!
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would simplify. I dont think everyone would get the joke.

Suggested change
In this module you interact with the tools providing in the console. You **import** data. You **query** data. You **explore** data. You **dashboard** data. Wait ... erm ... you **build a dashboard on top of your data**!
In this module you will interact with the console tools. You will **import** data. You will **query** data. You will **explore** data. You build a **dashboard** on top of your data.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@martinohanlon martinohanlon martinohanlon left review comments

At least 1 approving review is required to merge this pull request.

Assignees

@irina-loghin-neo4j irina-loghin-neo4j

Labels
draft
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
3 participants
@adam-cowley @martinohanlon @irina-loghin-neo4j