jpgough / api-workshop Goto Github PK
View Code? Open in Web Editor NEWWorkshop on building APIs with best practice in mind
Workshop on building APIs with best practice in mind
Improvements from the original lightning talk required for conference
This image appears to be missing https://github.com/jpgough/api-workshop/blob/master/02-contracts/images/pact_broker.png
The Version presentation references the API lifecycle from PayPal.
We should include references of MSFT and there standards.
A short demo of Service Mesh capability
Improvements from the existing lightning talk
Java 12 has gone EOL and the workshop images etc are not available for 13.
Suggest we move to use Java 11.
Slide title form slide 2 should be changed to what will be covered
https://github.com/jpgough/api-workshop/tree/master/prerequisites#download-springboot-project
Instead of - "The following URL is pre-configured to take you directly to https://start.spring.io and download a zip file containing the project. Just open your browser and enter the URL, the download should begin.",
It should be:
"The following URL is pre-configured to take you directly to https://start.spring.io and set the required dependencies to Spring Web and Spring Contract Verifier. Open your browser and enter the URL, and then click on "Generate" to download a zip file containing the project."
Intellij Project Import and Eclipse Project Import images aren't loading.
When using AdoptOpenJDK the JDK is not installed in Contents/Home
It is in c:/ProgramFiles/AdoptOpenJDK/
This should be selected NOT the Contents/Home location
Introduction to API Gateway
Improvements from the existing lightning talks
Demo walkthrough of API Gateway with our sample API
Java -jar command typo, needs a space after api-docs
Add
@RunWith(SpringRunner.class)
@SpringBootTest
example for the Contract base if you want to go pure spring.
This all needs to be put in the Solution
Step One and Step Two need removing from lab 1 and should instead just be a link to the pre-reqs
In the solution the /todos API returns a Map, which is not a List as specified by the lab. Can we check this for consistency as this will also appear during the contract testing
Couple of notes on the app for the first part of the app.
An improvement that was mentioned and would streamline the process for attendees is to make the swagger-diff lab more efficent.
At present it required that the CLI Swagger diff tool is available and this includes having Ruby.
What would be better is to have the java lib from http://deepoove.com/swagger-diff/ available and use this to compare swagger specs
Add in pre-req details with new links and make docker section optional
The images in the presentation that show the Versioned containers/serverices is large and shows 6 of them. This can be made smaller and would provide more clarity. 4 of these containers would be better
Windows home has a limitation with the Docker installation.
We need to document any potential work arounds.
Follow steps here:
https://docs.docker.com/toolbox/toolbox_install_windows/
download version 19.03.1
A new set of slides should be created that can be used to discuss API Best practacies.
This should have some best practacies from MSFT included. It is important to show that that the key part is to take a standard and follow it. This will give you consistancy
Improvements on the current lightning talk
Currently the slides on Best Practacies for building API's is an overview.
These points should be expanded upon and explained as attendees will want to know more about these subjects when designing there API's
Lab 3 images need to be updated to the new URL format
Following on from the API Gateway Deck introduces the Service Mesh briefly in the role of loopback
Rather than ask people to download the swagger-codegen-cli as a pre-req, maybe we could just add the JAR to the repo under correct lab? One less step for people to do.
http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.3.1/swagger-codegen-cli-2.3.1.jar
Transition is too abrupt.
In intelliJ select and Open the build.gradle file
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.