Aura dashboards feedback editorial #438

irina-loghin-neo4j · 2025-11-25T15:47:26Z

Choose a Pull Request Template

Please choose the appropriate template for your PR:

[General Update Template] (continue with this template)

General Update PR

Description

Fix image paths, added newlines, made the storyline about implying the learner is part of a movie studio consistent accros lessons, fixed question not being marked correct - it had the same title as a lesson section

Related Issues

Closes #[issue number]

Testing

[ x ] Tested locally
[ x ] All existing tests pass

adam-cowley · 2025-12-01T21:34:45Z

asciidoc/courses/aura-dashboards/course.adoc

+You will explore the Dashboards interface, learn about different visualization options for data representation, and discover the built-in tools for data exploration and visualization.

-This course will prepare you to visualize and understand the Neo4j databases in the cloud with confidence.
+This course will prepare you to visualize and understand Neo4j databases with confidence. While the examples use Neo4j Aura for ease of access, the same features are available in Neo4j Enterprise Edition on-premises.


... understand Neo4j databases with confidence? I'm not sure what that means

Are all the same features available with Neo4j enterprise edition?

adam-cowley · 2025-12-01T22:05:08Z

asciidoc/courses/aura-dashboards/course.adoc

@@ -1,30 +1,37 @@
-= Building Dashboards in Neo4j Aura
+= Building Dashboards in Neo4j


Should this be Building Dashboards with Neo4j rather than in Neo4j?

adam-cowley · 2025-12-01T22:07:50Z

...es/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/lesson.adoc

+* **Neo4j Enterprise Edition on-premises** - If you already have access

-Create an account and an instance by following these instructions:
+The rest of this lesson focuses on setting up Neo4j Aura. If you're using on-premises, skip to **Step 4** to learn how to connect.


If you're using a Self-Managed version of Neo4j

adam-cowley · 2025-12-01T22:09:33Z

.../courses/aura-dashboards/modules/1-getting-started/lessons/1-what-are-dashboards/lesson.adoc

-
-To do this, you can use natural language to ask questions about your data, and Aura Dashboards will generate the necessary visualisations for you. 
-Writing Cypher queries is not required, although you can use them if you prefer. 
+To do this, you can use natural language to ask questions about your data, and Neo4j Dashboards will generate the necessary visualizations for you. 


~~To do this,~~ You can use the Ask With AI feature to ask questions about your data and generate complete dashboard visualisations

adam-cowley · 2025-12-01T22:11:52Z

...es/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/lesson.adoc

+== Dashboard page limits

-* Free tier: 3 dashboard pages available. If you have already created a free tier instance, you can access upgrade at any time to access more dashboards.
+The number of dashboard pages you can create depends on your platform:


We call these tiers, don't we?

adam-cowley · 2025-12-01T22:12:19Z

...es/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/lesson.adoc


 image::images/ee-dashboards.png[Enterprise tier dashboards,width=600,align=center]

+**For on-premises Enterprise Edition users:**


Self-Managed

adam-cowley · 2025-12-01T22:13:04Z

...courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/lesson.adoc

+Prior to using the AI tool, ensure that you have read the AI disclaimer available in the Dashboards interface: 

 image::images/genai-disclaimer.png[AI disclaimer dialog,width=600,align=center]


Is this necessary to state?

adam-cowley · 2025-12-01T22:14:00Z

asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/1-first-card/lesson.adoc

 You will learn how to:

-* Connect to your Aura instance using the integrated Query tool.
+* Connect to your Neo4j database using the integrated Query tool


Connect to your Neo4j ~~database~~ instance using the integrated Query tool

adam-cowley · 2025-12-01T22:18:44Z

...doc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/3-further-steps/lesson.adoc

+In the previous lessons, you learned how to create, customize, and share dashboards.

-In this section, you will learn about additional resources and next steps to continue your journey with Neo4j Aura.
+In this section, you will learn about additional resources and next steps to continue your journey with Neo4j Dashboards.

 Feel free to ask any questions in the chat!


+== Final Project: Build Your Stakeholders Dashboard
+
+Now it's time to apply everything you've learned by creating a comprehensive, production-ready dashboard.
+
+
+=== Project Overview
+
+**Scenario:** Design a dashboard for a streaming service to support content acquisition decisions. The dashboard will serve three stakeholder groups: executives, marketing team, and content acquisition team.


I would call the lesson "Final Project..." and put a read button at the bottom so it triggers the completion modal. Otherwise it seems a bit disjointed

Maybe make it a :type: challenge too

martinohanlon

Summary:

There are some challenges around flow in the course. There is a lesson about "create your first card", in previous lessons they create a card.
Importing data process is confusing, I wasnt sure what the learner was meant to do. I would strongly suggest picking 1 approach and being consistent. Cater for the majority not the minority.
The Aura / Enterprise notes created confusion for me.
There are options to simplify the language and lower the cognitive load.
Some of the questions arent covered by the lesson content.

martinohanlon · 2025-12-02T09:12:41Z

asciidoc/courses/aura-dashboards/course.adoc

-In this course you will learn about Aura Dashboards, a feature for visualising and exploring graph data directly within the Aura environment.
-You will learn how to access Aura Dashboards, import and visualize data, create interactive dashboards using AI and Cypher queries, and share dashboards with others.
+In this course you will learn about Neo4j Dashboards, a feature for visualizing and exploring graph data directly within Neo4j.
+You will learn how to access Dashboards, import and visualize data, create interactive dashboards using AI and Cypher queries, and share dashboards with others.


maybe bullet point this list to make it easier to read

martinohanlon · 2025-12-02T09:14:04Z

asciidoc/courses/aura-dashboards/course.adoc

+You will explore the Dashboards interface, learn about different visualization options for data representation, and discover the built-in tools for data exploration and visualization.

-This course will prepare you to visualize and understand the Neo4j databases in the cloud with confidence.
+This course will prepare you to visualize and understand Neo4j databases with confidence. While the examples use Neo4j Aura for ease of access, the same features are available in Neo4j Enterprise Edition on-premises.


Are all the same features available with Neo4j enterprise edition?

martinohanlon · 2025-12-02T09:14:59Z

asciidoc/courses/aura-dashboards/course.adoc

+* A basic understanding of graph databases and Neo4j
+* Access to a Neo4j database - either:
+  ** Neo4j Aura (free tier available) - recommended for new users
+  ** Neo4j Enterprise Edition on-premises with Dashboards enabled


maybe link out to the docs where they can find how to enable dashboards on enterprise

martinohanlon · 2025-12-02T09:17:01Z

asciidoc/courses/aura-dashboards/course.adoc

+  ** Neo4j Aura (free tier available) - recommended for new users
+  ** Neo4j Enterprise Edition on-premises with Dashboards enabled
+
+If you are new to Neo4j, you can familiarize yourself with the database using the link:/courses/neo4j-fundamentals/[Neo4j Fundamentals course^], the link:/courses/aura-fundamentals/[Aura Fundamentals course^] and the link:/courses/cypher-fundamentals/[Cypher Fundamentals course^].


Maybe bullet point this and provide the course caption so people know what the courses are.

* link:/courses/neo4j-fundamentals/[Neo4j Fundamentals course^] - Learn about Graph databases and get started with Neo4j

martinohanlon · 2025-12-02T09:19:09Z

.../courses/aura-dashboards/modules/1-getting-started/lessons/1-what-are-dashboards/lesson.adoc

 Ever wondered how movie recommendation systems work, or how studios track which genres are trending? 

-Representing data in a visual format can help uncover patterns that might be missed otherwise. 
+Representing data in a visual format can help uncover patterns that might be missed otherwise.


You could lose otherwise - "otherwise what?"

Suggested change

Representing data in a visual format can help uncover patterns that might be missed otherwise.

Representing data in a visual format can help uncover patterns that might be missed.

martinohanlon · 2025-12-02T12:31:52Z

asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc


-== Sharing your dashboards
+* Share dashboards based on your Neo4j user management system
+* Consult your database administrator for user access procedures


same comments as below - they might not had a database admin

martinohanlon · 2025-12-02T12:32:53Z

asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc


 image::images/1-invite-users-2.png[Email address added to the invite users field]

 [start=5]


Should this now be 3?

martinohanlon · 2025-12-02T12:33:04Z

asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc


 image::images/1-users-roles.png[Project role drop down showing the different roles available]

 [start=6]


martinohanlon · 2025-12-02T12:33:35Z

asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc

-. Click **Send Invites** to send the invitations
+. Click **Send Invites** to send the invitations.

 [start=7]


5?

You can format the asciidoc so you dont need to specify starts.

martinohanlon · 2025-12-02T12:34:53Z

...doc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/3-further-steps/lesson.adoc

+In the previous lessons, you learned how to create, customize, and share dashboards.

-In this section, you will learn about additional resources and next steps to continue your journey with Neo4j Aura.
+In this section, you will learn about additional resources and next steps to continue your journey with Neo4j Dashboards.

 Feel free to ask any questions in the chat!


+== Final Project: Build Your Stakeholders Dashboard
+
+Now it's time to apply everything you've learned by creating a comprehensive, production-ready dashboard.
+
+
+=== Project Overview
+
+**Scenario:** Design a dashboard for a streaming service to support content acquisition decisions. The dashboard will serve three stakeholder groups: executives, marketing team, and content acquisition team.


Maybe make it a :type: challenge too

martinohanlon

Summary:

There are some challenges around flow in the course. There is a lesson about "create your first card", in previous lessons they create a card.
Importing data process is confusing, I wasnt sure what the learner was meant to do. I would strongly suggest picking 1 approach and being consistent. Cater for the majority not the minority.
The Aura / Enterprise notes created confusion for me.
There are options to simplify the language and lower the cognitive load.
Some of the questions arent covered by the lesson content.

irina-loghin-neo4j added 2 commits November 25, 2025 17:13

added newlines at the end of question files

7317ad2

rephrased the storyline and added some fixes to images paths

ad36f12

irina-loghin-neo4j force-pushed the aura-dashboards-feedback-editorial branch from 51945a8 to ad36f12 Compare November 25, 2025 17:18

irina-loghin-neo4j requested a review from martinohanlon November 27, 2025 10:11

adam-cowley reviewed Dec 1, 2025

View reviewed changes

martinohanlon reviewed Dec 2, 2025

View reviewed changes

		@@ -1,30 +1,37 @@
		= Building Dashboards in Neo4j Aura
		= Building Dashboards in Neo4j


		image::images/ee-dashboards.png[Enterprise tier dashboards,width=600,align=center]

		For on-premises Enterprise Edition users:

		Prior to using the AI tool, ensure that you have read the AI disclaimer available in the Dashboards interface:

		image::images/genai-disclaimer.png[AI disclaimer dialog,width=600,align=center]

	Representing data in a visual format can help uncover patterns that might be missed otherwise.
	Representing data in a visual format can help uncover patterns that might be missed.


		image::images/1-invite-users-2.png[Email address added to the invite users field]

		[start=5]


		image::images/1-users-roles.png[Project role drop down showing the different roles available]

		[start=6]

Aura dashboards feedback editorial #438

Are you sure you want to change the base?

Aura dashboards feedback editorial #438

Uh oh!

Conversation

irina-loghin-neo4j commented Nov 25, 2025

Choose a Pull Request Template

General Update PR

Description

Related Issues

Testing

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

martinohanlon left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

martinohanlon left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants