269879 - FAQ: update for file menu "How can I access Local Calendar(s) from different Mozilla products?"

Status: RESOLVED FIXED

(Calendar :: Website, defect)

Description

[gekacheka]

User-Agent:       Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.7.5) Gecko/20041107 Firefox/1.0
Build Identifier: 

The file menu has been changed to include both "New Calendar File" and "Open
Calendar File", as has the calendar context menu.  It no longer uses the same
command for new and open, and no longer requires saying Yes to the Overwrite?
dialog to open an existing file.  The FAQ needs to be updated.

Reproducible: Always
Steps to Reproduce:
1. See url

Actual Results:  
How can I access Local Calendar(s) from different Mozilla products?

Suppose Firefox calendar is the base application. Switch to the "Calendars" tab.
Right click and select "New Calendar". Enter a location and filename to be your
base calendar file. To test add an event and make sure the event has been added
to that file by viewing it. Now launch Thunderbird calendar and do the same with
the same filename. Once you get the "Overwrite?" dialog choose "Yes". Refresh
your view by navigating between months. You should see the event you added in
firefox calendar. Proceed with sunbird just the same.

Expected Results:  
How can I access Local Calendar(s) from different Mozilla products?

    Use "New Calendar File" to create a new local file in one program,
    and "Open Calendar File" to open the same local file from the
    other program.<p>

    For example, suppose you first launch Calendar from Firefox.  In the
    File menu, click "New Calendar", and enter the filename to be your
    calendar file.  To test, select the new file in the Calendars tab,
    then click New Event to add a new event.  Check that the event has
    been added to that file by viewing it.  Click-right on the calendar
    and click "Edit Calendar" to verify where it is stored.  Now launch
    Calendar from Thunderbird.  In the File menu, click "Open Calendar",
    and open the same file.  You should see the event you added in from
    Firefox.  Add another event from Thunderbird calendar, then refresh
    the view from Firefox calendar, say by navigating between months.
    Proceed with Sunbird just the same.  (Be careful not to modify a
    calendar file from two programs at the same time, or you may lose
    data.)

[Suggested replacement]

Comment 1

[Simon Paquet [:sipaq]]

gekacheka, in future please CC me on all bugs covering the website or its content.

> How can I access Local Calendar(s) from different Mozilla products?
> 
>     Use "New Calendar File" to create a new local file in one program,
>     and "Open Calendar File" to open the same local file from the
>     other program.<p>

I would prefer "File -> New Calendar" and "File -> Open Calendar".
 
>     For example, suppose you first launch Calendar from Firefox.  In the
>     File menu, click "New Calendar", and enter the filename to be your
>     calendar file.  

To do this, launch Calendar from Firefox. Then click "New Calendar" in the file
menu and enter the filename to be your calendar file.

>     To test, select the new file in the Calendars tab,
>     then click New Event to add a new event. 

Then test this by selecting the new calendar in the Calendars tab and adding a
new event to this calendar.


The rest is fine. Can you provide a patch or do you want me to do it?

Comment 2

[Michiel van Leeuwen (email: mvl+moz@)]

(In reply to comment #1)
> >     In the
> >     File menu, click "New Calendar", and enter the filename to be your
> >     calendar file.  
> 
> Then click "New Calendar" in the file
> menu and enter the filename to be your calendar file.

I disagree with that change. the original is in chronological order, the
alternative isn't. First you click file, then you select "new calendar". I think
it is easier to remember if the text also uses that order.

Comment 3

[gekacheka]

Attachment: Revised text, using <ol>, explicit names for file/event/task, and toggle checkmark to refresh.

Here is a clarified revision.
* uses <ol> to clarify hierarchy of steps
* uses specific names of file (MyCal.ics), event (My Lunch), task (My Workout).

* uses calendar checkmark to refresh (navigating view does not refresh tasks,
toggling the checkmark seemed to work when I tried it.)

Uses style to give different step levels different numbering.  Is this ok
within the web site style?

Comment 4

[Simon Paquet [:sipaq]]

Changes checked in. I made some minor content and markup changes to make it valid.

Gekacheka, in future please try to avoid using tabs in the HTML code. And thanks
for the patch, of course :-))

Comment 5

[Simon Paquet [:sipaq]]

Attachment: Patch that I checked in

For reference purposes. Here's the patch that I checked in.

Comment 6

[gekacheka]

Ok.  Rereading I suggest maybe changing "outline" to "outline border", as
reading this in the context of an outline made me think it was going open an
outline under the calendar...

This patch alone does not give the step levels different numbering styles, so it
can be confusing to read.  Is it possible to add the list styling?

emacs: m-x untabify (converts tabs to spaces in region)

Comment 7

[Simon Paquet [:sipaq]]

(In reply to comment #6)
> Ok.  Rereading I suggest maybe changing "outline" to "outline border", as
> reading this in the context of an outline made me think it was going open an
> outline under the calendar...

Fixed.

> This patch alone does not give the step levels different numbering styles, 
> so it can be confusing to read.  Is it possible to add the list styling?

Done.

Comment 8

[Reed Loden [:reed]]

The bugspam monkeys have been set free and are feeding on Calendar :: Website. Be afraid for your sanity!