Closed Bug 150149 (bz-2.18-relnotes) Opened 18 years ago Closed 15 years ago

2.18 Release Notes Bug

Categories

(Bugzilla :: Bugzilla-General, defect, P1, blocker)

2.17
defect

Tracking

()

RESOLVED FIXED
Bugzilla 2.18

People

(Reporter: CodeMachine, Assigned: mkanat)

References

()

Details

Attachments

(1 file, 4 obsolete files)

2.17/2.18 Release Notes.

Please enter only changes from the 2.16 release notes in docs/rel_notes.txt.

I expect the following to be documented:

- all significant fixes and enhancements implemented
- all changes to the deprecated features and outstanding major problems
- changes in software dependency requirements
Priority: -- → P1
Target Milestone: --- → Bugzilla 2.18
Alias: bz-2.18-relnotes
*** Bug 159789 has been marked as a duplicate of this bug. ***
We have bumped a /lot/ of minimum versions for modules this cycle.  We need to
make sure we mention that :)
Hmmm, we should probably start working on fixing up the release notes now... 
there's been enough changes this time around it'll probably take between now and
when we release to get it all updated.
Flags: blocking2.18+
ping MattyT: gonna have time to mess with this?  It'll be a rather huge job this
time, and we're running out of time.
Prerequisites only change from what is in docs/rel_notes.txt is...
CGI 2.93

Note the changes to the release notes I checked in on bug 254360, comment 1.
Whiteboard: bug awaiting patch
I think Matty said we messed this all up when we did it for the rc1 release. All
the "upgrading from older versions" stuff disappeared, for one.
Can we please remember to put in the release notes or release announcement a
link to http://www.bugzilla.org/installation-list/? It could do with the
publicity. We have 350 installations listed now; I think we could double or
triple that number easily.

Gerv
The full list is not visible at my side.  Only a lot of newlines with some <br>
tages.
Oops. My mistake - fixed in CVS. Sorry about that :-( Try again in five minutes.

Gerv
Last time I checked, we have one major issue that needs mention in the release
notes that isn't yet, and that's how the permissions work with the new charting
stuff.

MattyT also had a bunch of stuff he wanted done to it (he was complaining about
the upgrade notes from prior versions disappearing out of it, and those still
need to be there, so they need to get put back).
I'll work on now updating what needs to be updated. I think we have most things
in there. I have never used the new charting system, so I'd need some help with
that, unless there's already docs on it that I can read or point people to.
Attached patch Basic Relnotes patch (obsolete) — Splinter Review
This patch includes everything I could find by looking at bugs fixed with a
Target Milestone of 2.18, that wasn't already in the Release Notes.

Now all that remains is getting some docs on how the charting permissions work,
which should probably be done by Gerv since he understands bug 225687.
Actually, one small fix that can be made on checkin:

It really *should* be "over two years" and not "over three years" like I changed
it to. The release status update for 2.16 is dated 2002-07-28.
OK, I've discussed this with gerv and he's going to write the notes tomorrow,
his time.

I also realized that I have a bit more extensive work to do to make these notes
as comprehensive as the 2.16 notes.
Assignee: justdave → mkanat
Attached patch Major Relnotes Work (obsolete) — Splinter Review
OK, this is actually almost all of the relnote work that needs to be done. I
added back in all of the information that got cut out, and looked over a
ZILLION bugs and created the "Outstanding Issues" list. I also re-worked the
Upgrade Instructions a bit to be easier.

This needs two things:

1) A description of how the charting stuff that *IS* implemented works. This
can go as a FEW SENTENCES underneath the "Generic Charting" section of new
features.

2) A FEW SENTENCES where I've put "FIXME" in the current patch, to address the
lack of a UI for certain New Chart stuff.
Attachment #170598 - Attachment is obsolete: true
Attachment #170633 - Flags: review?
Whiteboard: bug awaiting patch → patch awaiting review
Attached patch Version 3 (obsolete) — Splinter Review
I made a few corrections and additions. The input from Gerv is still needed,
though.
Attachment #170643 - Flags: review?
Attachment #170633 - Attachment is obsolete: true
Attachment #170633 - Flags: review?
Here's the FIXME part:

- bug 276230: The support for restricting access to particular Categories of New
Charts is not complete. You should treat the 'chartgroup' Param as the only
access mechanism available. However, additionally, migrated charts will be
restricted to the groups that are marked MANDATORY for the corresponding
Product. There is currently no way to change this restriction, and the groupings
will not be updated if the group configuration for the Product changes.

> +- (No Bug Number) If you have a lot of non-ASCII data in your Bugzilla, don't
> +  enable the XS::Stash option when you install the Template Toolkit, or your 
> +  Bugzilla installation may become slow.

Weren't we going to tell people not to turn on XS::Stash if they were using a
non-ISO-8859-1 localisation?

Gerv
What's New?
***********

Generic Charting
-----------------

Bugzilla has a new mechanism for generating charts (graphs over time) of any
arbitrary search. This is known in the UI as "New Charts". The old charting
mechanism ("Old Charts") remains, but is deprecated and will be removed soon.
Legacy data from the old is migrated into the new at the time of upgrade, and
the two run in parallel.

New personal charts can be defined by anyone who is a member of the group given
in the Param 'chartgroup'. These have a maximum frequency for data collection of
7 days. Charts created by an administrator can be made public (visible to all)
by that administrator, and have a maximum frequency of 1 day.

The data is collected by the collectstats.pl script, which an administrator will
need to arrange to be run every day (see the manual). Chart data can be plotted
in a number of different ways, and different data sets can be plotted on the
same graph for comparison.

Please see the Known Bugs section for some important limitations relating to
access controls on charts.
Attached patch Version 4 (Complete) (obsolete) — Splinter Review
OK, this version is complete, as far as I know. I added all of Gerv's
contributions. I edited them slightly so that they would be even clearer.
Attachment #170643 - Attachment is obsolete: true
Attachment #170676 - Flags: review?
Blocks: 277615
+Individual users can create charts as long as they are a member of the group
+specified in the Param 'chartgroup'. Data can be collected for personal charts 
+every seven days or more (as set by the user). Charts created by an 
+administrator can be made public (visible to all). Data is collected for 
+administrator charts every one day or more (as set by the admin).

This rewrite isn't quite correct. Individual users can only _see_ or create (I'd
use 'use') New Charts if they are a member of chartgroup. 

"Or more" is ambiguous; it seems to me to mean "or more frequently". That's why
I used "maximum frequency", but I admit, this isn't an easy one. How about just
leaving that part out? :-) Just say the bit about public-ness.

+Bugzilla now includes a very simple "Find a Specific Bug" page, in addition to
+its advanced search page.

Describe it as "Google-like" - then everyone will know what it is and why it's cool.

Gerv
Attachment #170643 - Flags: review?
Attached patch Version 5Splinter Review
OK, I've added:

1) Gerv's notes
2) A note about fixing series (see bug 276237)
3) The security advisory

I'm pretty sure that these are ready to go out, now.
Attachment #170676 - Attachment is obsolete: true
Attachment #170960 - Flags: review?
Attachment #170676 - Flags: review?
No longer depends on: 276237
Status: NEW → ASSIGNED
Checking in docs/rel_notes.txt;
new revision: 1.24.2.7; previous revision: 1.24.2.6
Status: ASSIGNED → RESOLVED
Closed: 15 years ago
Resolution: --- → FIXED
Whiteboard: patch awaiting review
QA Contact: matty_is_a_geek → default-qa
You need to log in before you can comment on or make changes to this bug.