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
A short demo of Service Mesh capability
Lab 3 images need to be updated to the new URL format
This image appears to be missing https://github.com/jpgough/api-workshop/blob/master/02-contracts/images/pact_broker.png
Improvements on the current lightning talk
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
Following on from the API Gateway Deck introduces the Service Mesh briefly in the role of loopback
Follow steps here:
https://docs.docker.com/toolbox/toolbox_install_windows/
download version 19.03.1
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
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
In intelliJ select and Open the build.gradle file
Improvements from the existing lightning talks
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
Introduction to API Gateway
Transition is too abrupt.
Java 12 has gone EOL and the workshop images etc are not available for 13.
Suggest we move to use Java 11.
The Version presentation references the API lifecycle from PayPal.
We should include references of MSFT and there standards.
Add in pre-req details with new links and make docker section optional
Slide title form slide 2 should be changed to what will be covered
Improvements from the existing lightning talk
Demo walkthrough of API Gateway with our sample API
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
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.
Couple of notes on the app for the first part of the app.
Windows home has a limitation with the Docker installation.
We need to document any potential work arounds.
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
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
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
Java -jar command typo, needs a space after api-docs
Step One and Step Two need removing from lab 1 and should instead just be a link to the pre-reqs
Improvements from the original lightning talk required for conference
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.