Bug Tracker

Opened 4 years ago

Closed 4 years ago

Last modified 4 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:


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 4 years ago by rwaldron

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

comment:2 Changed 4 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 4 years ago by rwaldron

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 4 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 4 years ago by dmethvin

  • Resolution set to fixed
  • Status changed from new to closed

comment:6 Changed 4 years ago by dmethvin

  • Component changed from unfiled to build
  • Milestone changed from None to 1.8
  • Priority changed from undecided to high
  • Summary changed from README doesn't reflect current build system to Update README to describe grunt build system
Note: See TracTickets for help on using tickets.