Code Monkey home page Code Monkey logo

developer-guides's Introduction

Neo4j Developer Guides

Installation

To build these docs locally you will need Node & NPM installed. Antora requires Node version 10 or higher.

To install the dependencies run:

npm install

Contributing

To make changes to this repository, please create a new branch to stage your changes. Your branch should be prefixed with the type of change, for example content/new-cypher-guide or fix/broken-links.

When you are finished with your changes push the branch to the remote repository and create a Pull Request. Please add at least one approver.

The changes will be merged into the publish branch, which will in turn trigger a rebuild of the content in the docs-refresh repository.

# Clone the repository
git clone https://github.com/neo4j-documentation/developer-guides

# check out a new branch
git checkout -b content/my-fix

# Make some changes to the repo
touch modules/ROOT/pages/new-guide.adoc

# State the changes
git add modules/ROOT/pages/new-guide.adoc

# Commit the changes
git commit -m "Added a new guide"

# Push to the remote repository
git push -u origin content/my-fix

At the end of the build process, the files are uploaded to the static-content.neo4j.com S3 Bucket. From there, they are synced up to the Neo4j.com server once an hour, on the hour by a cronjob.

Live Preview

To preview the docs run:

npm start

This will build a set of HTML files in build/site and then serve them through an express server at http://localhost:8000. The dev script will also listen for changes and automatically rebuild the files automatically. You’ll still need to refresh the page to view the changes.

developer-guides's People

Contributors

adam-cowley avatar alexandererdl avatar andyheap-neotech avatar bigmontz avatar cj2001 avatar cskardon avatar davidoliversp2 avatar dependabot[bot] avatar elainerosenberg avatar fbiville avatar florentind avatar ggrossetie avatar injectives avatar jexp avatar jmhreif avatar johnymontana avatar lju-lazarevic avatar madison-ookla avatar meistermeier avatar mneedham avatar moxious avatar nataliaivakina avatar renetapopova avatar richardirons-neo4j avatar robsdedude avatar stefanak-michal avatar stefano-ottolenghi avatar thelonelyvulpes avatar transistive avatar whatsocks avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

developer-guides's Issues

documentation style-guide not updated yet on the website?

I just read the Cypher Style Guide on the website and noticed the mistakes that #201 already fixed.
They are not present on the website up to now.

I think that's a considerably important fix which leads me to the question if I just need to wait longer or something went wrong with the update?

Rework the graphql page

  • update to current information
  • make it userful for folks learning about graphql and graphql + neo4j
  • app development
  • add useful (short videos)
  • replace db plugin stuff with grandstack
  • improve SEO

/cc @johnymontana

Create Desktop and Server Installation pages in developer guides

The desktop and server download thanks page are viewable after the download is finished, but the user does not have an easy way to get it back if they wanted.

So we want to move the content of those thank you page in the developer guide. We would want to have guide for different OS.

  1. Desktop - OSX - https://neo4j.com/download-thanks-desktop/?edition=desktop&flavour=osx&release=1.3.4&offline=false
  2. Desktop - Windows - https://neo4j.com/download-thanks-desktop/?edition=desktop&flavour=windows&release=1.3.4&offline=false
  3. Linux - https://neo4j.com/download-thanks-desktop/?edition=desktop&flavour=unix&release=1.3.4&offline=false

Community Server - OSX/Linux - https://neo4j.com/download-thanks/?edition=community&release=4.1.1&flavour=unix
Community Server - Windows - https://neo4j.com/download-thanks/?edition=community&release=4.1.1&flavour=winzip

Link formatting

it would be great if links and bold text would be visually more different

and if possible render links to developer guides different from links to other pages (incl. neo4j.com) (by @ElaineRosenberg )

Neo4j Developer Pages with Broken Links (Found through SEM Rush)

There are 18 links to developer pages that are giving 404 errors:

https://neo4j.com/developer/guide-data-visualization/
https://neo4j.com/developer/spark/spark/
https://neo4j.com/developer/neo4j-cloud-google-cloud-launcher/
https://neo4j.com/developer/spark/spark/writing/
https://neo4j.com/developer/mongodb/neo4j-doc-manager/
https://neo4j.com/developer/spark/spark/aura/
https://neo4j.com/developer/spark/spark/neo4j-cluster/
https://neo4j.com/developer/spark/spark/architecture/
https://neo4j.com/developer/spark/spark/python/
https://neo4j.com/developer/spark/spark/quickstart/
https://neo4j.com/developer/spark/spark/reading/
https://neo4j.com/developer/spark/spark/types/
https://neo4j.com/developer/spark/spark/faq/
https://neo4j.com/developer/spark/spark/configuration/
https://neo4j.com/developer/spark/spark/quick-java-example/
https://neo4j.com/developer/spark/spark/overview/
https://neo4j.com/developer/spark/spark/gds/
https://neo4j.com/developer/cypher/syntax/

Additionally, there are 2 links to graph gists pages that are giving 404 errors:

https://neo4j.com/graphgists/movie-recommendations-with-k-nearest-neighbors-and-cosine-similarity/
https://neo4j.com/graphgists/06bbc73b-80e9-45fc-a1d6-c0270745ddfb/

Remove CodeMirror inline scripts from the documentation

The documentation is no longer using CodeMirror (we are now using Highlight.js).
As a result we can remove the following passthrough blocks:

<script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.13.4/mode/javascript/javascript.min.js"></script>

<script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.13.4/mode/go/go.min.js"></script>

<script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.13.4/mode/python/python.min.js"></script>

<script src="https://cdnjs.cloudflare.com/ajax/libs/codemirror/5.13.4/mode/java/java.min.js"></script>

Update sentence

If we run the query we get a stream of triples (subject, predicate, subject).

Should be

If we run the query we get a stream of triples (subject, predicate, object).

Aura configuration settings

A big recurrent problem Aura is having with supporting Neo4j drivers is incorrect default config in the drivers. We need lower connection lifetimes, and more aggressive connection freshness checks, as typified by this kind of code in the java driver:

org.neo4j.driver.Config.builder()
.withMaxConnectionLifetime(8, TimeUnit.MINUTES)
.withConnectionLivenessCheckTimeout(2, TimeUnit.MINUTES)

Needs to be added here: https://neo4j.com/developer/aura-connect-driver/
And also to the front page of developer guides where we give copy/paste code samples of how to work with Aura.

See also this link for why this is an issue; it affects all languages https://aura.support.neo4j.com/hc/en-us/articles/360063143493-Recommendation-for-drivers-properties-when-running-an-application-on-Azure-to-connect-to-Aura-

Should https://neo4j.com/developer/developer_courses/ exist?

This page - https://neo4j.com/developer/developer_courses/ shows up in swiftype search on the website and maybe even in google search. When I go to this page, I don't see an active menu item in the left sidebar which makes me think that there isn't a way to directly reach here and maybe a dead page.

If we don't need it, lets delete it altogether. If we need it, then we should change the slug to developer-course for consistency.

@ElaineRosenberg @jexp

Missing BBC Good Food Recipe Data play command

The command for BBC Good Food Recipe Data in the Other Example Data section is missing. This section can be found on the following link:

https://github.com/sirReeall/developer-guides/blob/publish/modules/ROOT/pages/example-data.adoc#other-guide-examples

We can see that commands are listed for other example datasets:

Other examples that you can quickly run within your own Neo4j Browser are:

* `:play got` Game of Thrones Interactions
* `:play nasa` NASA knowledge graph example
* `:play ukcompanies` UK company registration, property ownership, political donations
* `:play stackoverflow` Stack Overflow users, tags and Q&A data

But for the BBC good food example set the command is missing:

* `	` BBC Good Foods recipe data

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.