Bug Tracker

Opened 6 years ago

Closed 5 years ago

Last modified 5 years ago

#11789 closed bug (fixed)

Update README to describe grunt build system

Reported by: dmethvin Owned by:
Priority: high Milestone: 1.8
Component: build Version: 1.7.2
Keywords: Cc:
Blocked by: Blocking:

Description

For someone who just wants to get up and running building jQuery, the grunt docs aren't clear at all. It's yet not a common enough build system to assume that everyone knows how to get and use it.

The grunt project README assumes the first thing you want to do is set up your own gruntfile, which isn't the case if you just need it to build jQuery. I didn't see any obvious reference to the npm install grunt that's needed, not even in the "Getting Started" guide!

Ideally we'd be able to delegate at least some of this to the grunt README, it really should be there.

Change History (6)

comment:1 Changed 6 years ago by Rick Waldron

Confirmed. I definitely need some help with this - but had completely forgotten that it needed to be addressed.

comment:2 Changed 6 years ago by dmethvin

Oh, I see npm install grunt is the *last* thing discussed in the README, probably just needs to be up top.

comment:3 Changed 6 years ago by Rick Waldron

Right, I didn't want to boot the existing instructions yet, so I threw it in later. Sorry for the completely lack of clarity :D

comment:4 Changed 6 years ago by dmethvin

Actually, if jaubourg is going to land JHP that will require more docs so we might as well do them together; sounds like a good topic for tomorrow's meeting. Scott pointed out that npm install does most of the work but I do think we should have a quick-start. That will become more important if we're going to have people building custom versions.

comment:5 Changed 5 years ago by dmethvin

Resolution: fixed
Status: newclosed

comment:6 Changed 5 years ago by dmethvin

Component: unfiledbuild
Milestone: None1.8
Priority: undecidedhigh
Summary: README doesn't reflect current build systemUpdate README to describe grunt build system
Note: See TracTickets for help on using tickets.