Entirely Sonja (entirelysonja) wrote in lj_userdoc,
Entirely Sonja
entirelysonja
lj_userdoc

Suggested change to FAQ 141

The beginning of FAQ 141 reads:

The most common cause of this problem is that you have entered overrides in the wrong format, or you are missing several required tags in your overrides.

For more information on proper syntax of overrides, including all necessary tags, please see http://www.livejournal.com/support/faqbrowse.bml?faqid=140 .

In particular, if you have a comment opening tag (<!--) with no comment closing tag after the CSS style declaration (-->), your journal will not display.

To fix this, you can edit your overrides and include the missing tags or correct the syntax. If you require further help with CSS syntax, you can search for "CSS tutorial" in your favorite search engine.


I would like to suggest changing the wording to:

The most common cause of this problem is that you have entered overrides in the wrong format, or you are missing one or more required tags in your overrides.

It is particularly important to make sure that all of your comment opening tags (<!--) have matching comment closing tags (-->) and that all of your <style> tags have matching </style> tags. A missing comment closing tag or </style> tag in your CSS style declarations will cause your journal not to display.

For more information on proper syntax of overrides, including all necessary tags, please see http://www.livejournal.com/support/faqbrowse.bml?faqid=140.

If you require further help with CSS syntax, you can search for "CSS tutorial" in your favorite search engine.


I suggest changing "several" to "one or more" because I suspect what was originally meant was something like "one of several"; it's certainly not the case that more than one tag needs to be missing in order for the problem to occur.

I think we should move the paragraph giving specific possible causes immediately after the first paragraph because it follows more directly from the first paragraph, and provides the reader with as much information as possible early in the document. I believe the information about the missing </style> tag is needed now due to the changes in the HTML Cleaner. Then they need the reference to FAQ 140 if that doesn't solve their problem or they need more information, and the suggestion about searching on the web for a CSS tutorial if they need still more information.

I was a little iffy on the sentence, "To fix this, you can edit your overrides and include the missing tags or correct the syntax," which I have omitted from my suggested revision. If such a sentence is needed, how about, "Once you have determined the cause of the problem, you will need to edit your overrides on the Modify Journal screen (http://www.livejournal.com/modify.bml) to include the missing tags or correct the syntax."

What do you think?
Subscribe
  • Post a new comment

    Error

    Comments allowed for members only

    Anonymous comments are disabled in this journal

    default userpic

    Your reply will be screened

    Your IP address will be recorded 

  • 5 comments