Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Concepts - "Why webpack?" Section #1801

Open
TheLarkInn opened this issue Jan 24, 2018 · 9 comments
Open

Concepts - "Why webpack?" Section #1801

TheLarkInn opened this issue Jan 24, 2018 · 9 comments

Comments

@TheLarkInn
Copy link
Member

Linked is one of the best explainers (and is trending on Reddit [or was]) on why bundlers are what someone should use for High Performance web applications (and ergonomics). I'd like to see a "Why webpack". or "Why bundle". section somewhere as a top tier callout to visitors of the page.

This probably represents the final high level gap for general overview and resoning knowledge that we are missing here on the docs site.

Going to label this as a contribution opportunity, however @skipjack @TheDutchCoder if you have a great ideas where this could go, feel free to comment, design that location.

@gezeta-id
Copy link

Just so that it is clear: As I said in the original reddit comment, feel free to copy all, parts, pieces, tiny bits or whatever you want from my comment. No attribution needed or anything. If it helps you, great 😄

@TheLarkInn
Copy link
Member Author

Thank you kindly! @gezeta-id

I'd try and twist you to submit a PR for this but you've already done so much. This is a great contribution opportunity too for first timers also.

@skipjack
Copy link
Collaborator

So we actually did used to have a page called "Why Webpack?" but I think it was renamed as "Comparison" (which makes sense for what the page contains). I think the best place for @gezeta-id's content would be the index page in Concepts. Nice work on that post @gezeta-id and I do think it would be a useful add to the site. Whoever ports that post would have to clean up the grammar and tighten it up as much as possible. That said, I do think the story being told is perfect for the Concepts section.

I'd like to see a "Why webpack". or "Why bundle". section somewhere as a top tier callout to visitors of the page.

The lead-in page of Concepts would be perfect as it's already the first link under Documentation and has a callout on the landing page:

image

Interested in @jeremenichelli's and @TheDutchCoder's thought as well. Updating the title/labels to reflects my suggestion of the Concepts section but we can change it if we decide there is a better place for it.

@skipjack skipjack changed the title "Why webpack?" Section. Concepts - "Why webpack?" Section Jan 24, 2018
@TheDutchCoder
Copy link
Collaborator

I, too, love this idea of explaining "why" one would need (or like to use) webpack.

When we redid the guides it was very much beginner focussed (I'm literally a newbie at webpack and helped rewriting them for people like me) and I think this ties into that nicely.

Having it front and center in the navigation is vital as well, as I think a lot of beginners could use the encouragement and explanation it provides. The whole "let's take this one step at a time" approach resonates with me as a beginner, it's excellent!

Webpack is a bit "scary", but as this post illustrates, it really doesn't have to be and you (and probably should) start super small, get familiar with it, and then scale it up.

Anyway, enough rant, I'm 💯 for this idea and great work @gezeta-id !

@MythicalFish
Copy link

I bookmarked that comment because it was so good, and now that I want to refer to it again, it's gone! Deleted. :(

Did anyone here save it somewhere per chance?

@gezeta-id
Copy link

gezeta-id commented Mar 11, 2018

Oh, sorry, sorry! I forgot to tell you.

The reddit content on that account is usually deleted after a time, so I just moved it without modification to a more stable location: This is the original text as was published in reddit. This is a somewhat cleaner version
The clean version will be kept there for the foreseeable future, the other, unedited one maybe not. Still, let me remind you that you're free to copy it, if you so prefer.

@TheLarkInn
Copy link
Member Author

Thank you for publishing this to keep it accessible!! I think it is a perfect start for our documentation. Just need to figure out how we want to structure the message we send and find out where it would be sent 💯

@chrisdothtml
Copy link
Member

This seems more fitting for a post on the Webpack Blog. Could just be linked to where @skipjack screenshotted. Something like:

Struggling to understand webpack? [This blog post] might help.

@sudipt1999
Copy link

@TheLarkInn may I work on this ! kindly provide me pointers to begin with !

@skipjack skipjack removed their assignment May 5, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

7 participants