Giter VIP home page Giter VIP logo

onramp's Introduction

Onramp - Providing an easy entrance into Laravel for new developers.

Onramp

Contributor Covenant Run tests

Onramp aims to be a collection of resources presented in a way that makes it possible for folks to become Laravel programmers as easily and effectively as possible.

Requirements

Vite requires node ^14.18.0 || >=16.0.0 to run

How can I help?

Check out the Contribution Guide to learn more about how to contribute.

Language translations

To make language translation strings available to the Vue.js frontend, a translations.js file is generated from the Laravel language files found in the resources/lang directory. To regenerate this translations.js file after translations have been changed or added, run:

php artisan export:messages-flat

Seeding Data

Onramp creates and uses JSON files to seed your local database. To update these JSON files use the following command. Be sure to commit your changes to the repo:

Note: You may run the below command without the --all flag to choose a table to sync. Run with --override to automatically override the contents in an existing seed file.

php artisan generate:seeds-from-db --all

Then, to seed your local database run:

php art migrate:fresh --seed

Warning: Any changes made to your local database will be overridden when seeding your database from the production seeder files.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

Support us

Tighten's whole-business approach transcends engineering, propelling software-driven businesses forward with clarity and confidence. You can learn more about us on our web site.

onramp's People

Contributors

andrewmile avatar damiani avatar darkboywonder avatar dependabot[bot] avatar driftingly avatar eduarguz avatar faxblaster avatar foxted avatar gummibeer avatar jasonlbeggs avatar jonsugar avatar joseborges avatar kennith avatar ktsubouchi avatar laravel-shift avatar logichub avatar luky72069 avatar m50 avatar marcusmoore avatar marcylina avatar mattstauffer avatar olsza avatar rizkyarlin avatar rontu85 avatar sipman avatar skylerkatz avatar tammytee avatar treggats avatar wotta avatar zuzana-kunckova avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  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  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

onramp's Issues

[Suggestion] Do not separate resources by languages

Hi Matt.
I have a suggestion to do...

I think that onramp should not separate the resources by language.

When I first saw that you were adding language support to onramp, I tought that it was only a site content translation, and I think it is very nice, but I dont think that onramp should separate the resources by language.

It is not very clear that the resources when working on es are different than the resources when working on en. My main language is Spanish but I can properly understand resources in English, and many people can too... and that makes both of these resources useful for my learning. I think these resources should remain together or at least tagged or categorized but still in the same page view.

Just a suggestion ๐Ÿ˜‡
Thank you so much...

Translate the rest of the language to Spanish

Footer text ("From the lovely folks at Tighten", "Source & Roadmap"), header ("Login", "Register"). Content on the log in and register pages.

Don't need to translate the home page because it's all going to change soon anyway.

Allow for a wizard up front?

I'm imagining maybe this:

Welcome to Onramp!

Here are a few technologies that, if you're already familiar with, will impact the training we suggest. Choose as many as you need:

[HTML]
[CSS]
[Basic JavaScript]
[jQuery]
[WordPress implementation]
[WordPress plugin development]
[Git]
[Agile]

That's not an exhaustive list but it could be a good start. Then, when they choose them, we save it to their profile, and contextualize it.

Most of these options would just mean "don't show resources related to this because we assume they already know it." But at least WordPress would be a special case; that would add references designed specifically to help WP people transition.

Organize the content into bigger chunks

I'm thinking it might be better if there were clearer modules:

  • Basic web page creation
  • Terminal and git
  • Basic PHP
  • Advanced PHP
  • OOP
  • Basic Laravel
  • Advanced Laravel
  • APIs
  • Basic JavaScript
  • Basic Vue/React/whatever
  • Moving from WordPress (maybe more than one)
  • Basic Design Patterns (and other things that should target people brand-new to programming)
  • Basic application security practices

That way the organization of everything would be clearer, but also it'd be easier to turn certain chunks on and off based on the user's track.

Parse through these resources and add where appropriate

Ensure development environment section covers all 3 major platforms (Win/Mac/Linux)

While Valet is a fantastic tool, it's only for Mac users and one of the pain points I've experienced myself and heard from others is trying to get a development environment installed on Windows.

If we can provide a simple set of instructions for getting started with development on Windows, that would probably be a great addition to the section on Development Environment.

If no one beats me to it, I'll try to write up some documentation on Homestead, since that works on all 3 platforms and is something I'm comfortable writing about, but that's not necessarily the "simple" setup either.

Maybe some kind of setup guide using XAMPP and php artisan serve?

Add a section on moving from WordPress to Laravel

I talked with @mattstauffer a bit at Laracon about adding a section for WordPress devs getting into Laravel. A lot of WordPress folks like myself are using more and more Laravel and it would be good to help translate some concepts from WordPress to Laravel to help.

Some ideas:

I'll ask @twigpress if he has ideas about this.

Translatable glossary of terms

Provide a translated glossary of terms where users can easily find explanations of key Laravel/PHP terminology explained in their own language.

Add Git guide link

When it comes to learning git I've found that this resource is really really good.
http://rogerdudler.github.io/git-guide/

It's not overwhelming but gives you a good idea about how to work with git.
Works very well as a reference in the beginning after you've learned why to use git in the first place.

Add SQL training

W3Schools is a great resource for basic (and not so) SQL queries and what is it all about. Without overwhelming theory.

https://www.w3schools.com/sql/

I'd place it under the CSS section since one I/O device is the web, another can be CLI, and the other is for sure the database. It's better to have some understanding of it.
Besides, it makes you think on a declarative language which is how we want Laravel to be, it forms your brain into asking the computer what do you need instead of trying to make the computer do something.

Question and suggestion: which markdown

Hey Tighten, this is a cool project of yours I just discovered.

One thing I have been floundering around, is trying to figure out which markdown
you guys are running in Jigsaw.
Is it the Commonmark markdown?
Maybe this page should have a comment regarding which markdown is available??

Also, maybe a link on the onramp page would be helpful for those new to markdown.

Sorry if I am suggesting too much.

readme.md and contributing.md could include more info about getting started

There was chat elsewhere today about things like:

  • What is on different branches of this repo?
  • How PR's work
  • Which livestream videos should I watch? All of them? The latest?
  • Details of the database seeding

And I have my own questions about exactly what this repo is and if/how I can contribute.

I'll copy some conversation below for reference.

My reaction was to pop in here and see what the readme and contrinuting.md say, and that lead me to opening this issue to try and improve those documents.

@mattstauffer said:

one of the things i think would be really cool is if we can make this not only super easy for new folks to use, but also super easy for them to contribute to, AND we can maybe even use it and its readme/contributing.md/etc. as examples of how to make open source laravel projects friendly to new folks

So let's do that. I'll try and start making some improvements to the docs over the next couple of days. But feel free to chip in if I can't.

Relevant extracts/questions

How do the migrations/seeding work?

php artisan migrate:fresh โ€”seed

What IS the mes/database-backed-learning branch? Which should I use if contributing?

??? - need a general overview of branches - presumably this is explained in the videos?

How do PR's work with merging? (This started as a question along the lines of: "If I fork the repo and work on the master, then create a PR with my changes, won't it create conflicts if it's merged after other changes on master?")

Probably need to point off to another resource on "How to PR with Git/GitHub". This is old and JavaScripty, but may be a helpful 38 mins of free (I think!) video: https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github

Move 'Basic Terminal Commands' below HTML and CSS

Consider moving Basic Terminal Commands below HTML and CSS. Starting with the tools/technologies that can equip the learner to create something the fastest is more likely to keep them in the game and motivated. Also, I don't think the current HTML and CSS resources depend on knowing terminal commands.

Add non-code programming concepts

Easy to learn, dificult to master. It's better to have a look, even if you don't dominate, but at least know about and can search on later.

Easy to access, read and understand Design Patterns. Maybe not so accurate with some but better to approach than any other resource out there.
https://github.com/kamranahmedse/design-patterns-for-humans/blob/master/README.md

If you find links like this post please add on the comments for:
Data Structures
HTTP stack
Architecture concepts
etc.

Build tooling to make it possible to add caveats (e.g. Redis works differently on Windows) or OS-specific hints and links

Hi!
I want to propose to change the focus of development based on macOS as a de facto platform. Most future developers out there may not have access to a macbook or similar hardware so all the docs should include Windows and GNU/Linux links for tooling instalation and configuration on par with the huge amount of links we can find all over the place for macOS users.
I have been a Laravel (& Symfony) developer for the past 3 years (working on home projects with Windows 10 and at companies using GNU/Linux) and i've yet to try a mac. I don't need it, i don't want it and i don't hate it

People don't buy what you do, they buy why you do it.

(sic) Simon Sinek.

We need to let them know why we (as a more experience programmers) think they should complete this specific skill, at this specific stage. And we need to freshen up the idea of why we think this or that is important, and how it changed our lifes when we learned it.

This could become a UI/UX problem but never the less, keeping this in mind might be of use.
We should add an overview (with a tooltip or something more powerful, like media content of our own).
I think this should be added meta-content made from anyone who adds the contribution. This makes this site different from any wiki guide and reflects upon the mission and vision of this app.

for example, when (if) we add the section of SQL tutorial (#52 ), we explain why we think it would be beneficial, with something like:

At this stage, you're probably thinking something along the lines of "i'd love to make the computer do something!". The problem is that shouldn't try to hack your way through it, you could, but there is a better way. Why instead of hacking and forcing, we can just ask the right questions to get propper information? Why instead of making the computer do something, we can ask for it, and get it. Enter the void of the main data driven declarative language, SQL (Structured Query Language) !

๐Ÿ˜Š

Find a happy and healthy space for learning PHP

I'm not sure the best way to learn PHP from scratch, but I'm very aware there's a lot of really not positive and really not modern PHP resources out there.

What's the best free way to learn PHP? And, if not free, what's the best single comprehensive paid resource (books, video tutes, online courses, etc.)?

Preferably answered by people who've actually done it recently, rather than those of us who've been writing PHP since the dinosaurs but have heard of a thing once (e.g. me lol)

Set target attributes to _blank

Perhaps there is a reason for not doing this, but I think all links in the "Learn Laravel" section should have the target attribute set to _blank. Just as I did, other users will likely explore these sites further and navigating back can become a nuisance once you've gone down the rabbit hole.

Overall I'm really optimistic about onramp; I certainly wish this was around when I started and it never hurts to go back to basics, especially in our ever-changing industry. I look forward to using and sharing this great resource with friends and colleagues!

Add a pseudo-contributing document

Just giving this a look and thinking about what might be useful to add, I noticed there's not really a defined structure for how things should be formatted. Bullet points, paragraphs, etc?

Otherwise looks like a very promising resource.

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.