Improve documentation of notification config

[robsdedude]

• Brings format more in line with other messages and their fields
• Fixes seeming lack of Bolt 5.0 changes (temporal type representation moved to UTC, etc)
  caused by structure and message changes being listed separately.

[neo-technology-commit-status-publisher]

Looks like you've updated the documentation!

Check out your changes at https://neo4j-docs-bolt-30.surge.sh

[thelonelyvulpes]

One aspect that has been missed from the notifications config description is that by disabling a categories or severities means the server doesn't carry out analysis for those.
It may be out of scope of this document but I just thought I'd point it out.

[stefano-ottolenghi]

👙

[robsdedude]

One aspect that has been missed from the notifications config description is that by disabling a categories or severities means the server doesn't carry out analysis for those. It may be out of scope of this document but I just thought I'd point it out.

@thelonelyvulpes That's an interesting point I didn't consider. But I'd argue that these docs are more about the syntax of the protocol and only the semantics inherent to the protocol but not the those semantics defined by the DBMS. Just like we don't describe what Cypher is or how it works here.

On that note tho, this info should be documented somewhere! I'm just not sure where the best place would be? The driver docs? The cypher docs?

[ConorNeo]

One aspect that has been missed from the notifications config description is that by disabling a categories or severities means the server doesn't carry out analysis for those. It may be out of scope of this document but I just thought I'd point it out.

@thelonelyvulpes That's an interesting point I didn't consider. But I'd argue that these docs are more about the syntax of the protocol and only the semantics inherent to the protocol but not the those semantics defined by the DBMS. Just like we don't describe what Cypher is or how it works here.

On that note tho, this info should be documented somewhere! I'm just not sure where the best place would be? The driver docs? The cypher docs?

I agree i think this doc is not the place but should be somewhere!

[stefano-ottolenghi]

I'm just not sure where the best place would be? The driver docs?

I think driver docs is the best place -- or at least, it should be there, and optionally somewhere else as well. I am planning to add a section about notifications in the new manuals, so this will also go in.
I don't think it should be in Cypher since it's not something you can tweak through Cypher.

At the same time, I think there's no harm in dropping a sentence here in Bolt, somewhere. It is informative, and as long as it doesn't digress too much (but again, once sentence, as Grant wrote), it doesn't distract from the rest of docs.

[robsdedude]

@stefano-ottolenghi added a sentence (in 3 places though). What do you think?

[stefano-ottolenghi]

@robsdedude comma between those and which :)

[robsdedude]

As discussed, I've also adjusted the drivers' API docs

• Docs: mention performance impact of warning filtering. neo4j-python-driver#931
• Docs: mention performance impact of notification filtering. neo4j-dotnet-driver#703
• Docs: mention performance impact of notification filtering. neo4j-javascript-driver#1086
• Docs: mention performance impact of notification filtering. neo4j-java-driver#1425
• Docs: mention performance impact of notification filtering. neo4j-go-driver#493