New Ticket     Tickets     Wiki     Browse Source     Timeline     Roadmap     Ticket Reports     Search

Ticket #27078 (closed enhancement: fixed)

Opened 3 years ago

Last modified 2 years ago

Suggestion for section 3.3 of MacPorts Guide

Reported by: mk@… Owned by: markd@…
Priority: Normal Milestone:
Component: guide Version:
Keywords: common tasks Cc:
Port:

Description

Hi,

I wrote a few lines for section 3.3 of the guide.

Since there was no response on the mailing list concerning the usual workflow for bigger changes to the xml sources, I decided to file this as a ticket, because this gives one of the lead developers the chance to review my addition before I commit my changes to the SVN repo.

Hope my contribution is fit enough for inclusion into section 3.3.

Greets, Marko

Attachments

using.xml.diff (12.4 KB) - added by mk@… 3 years ago.
Content for section 3.3

Change History

Changed 3 years ago by mk@…

Content for section 3.3

comment:1 Changed 3 years ago by mk@…

  • Type changed from defect to update

comment:2 Changed 3 years ago by mk@…

Sorry, as posted on the ML I had this change already committed to the Guide. Had one iteration of the content already with Brad Giesbrecht, so I hope it's readable and suitable as a common tasks section.

comment:3 Changed 3 years ago by snc@…

It might be a bit repetitive, because some commands are already described somewhere else in this guide, but will give an overview of a typical maintenance workflow.

I would change this to: Some commands are described in further details elsewhere in the guide.

I don't believe you should be using variablelist for these entries—not in this manner at least. You may consider putting only the command in the term tag and the whole description inside the para tag.

comment:4 Changed 3 years ago by mk@…

I would change this to: Some commands are described in further details elsewhere in the guide.

I'll change it.

Well, concerning the variable list I just did what was done for the already existing entries... (One would have to change it for all other items accordingly.) I'll have a look at it during the weekend, I guess.

Thanks, snc! :)

comment:5 Changed 2 years ago by mk@…

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

Fixed in r73691.

comment:6 Changed 2 years ago by jmr@…

  • Version 1.9.1 deleted
  • Type changed from update to enhancement
Note: See TracTickets for help on using tickets.