HELP.adoc

A User’s Guide to Getting Help

Table of Contents

• Decision table
  • I am encountering a failure.
  • The library is not honoring an area of the CSS/HTML standard.
  • The library is not behaving as it claims or should.
  • I want to do X with this library, is it possible?
  • I am having trouble to understand how to use a specific feature of this library.

Decision table

Please read all the entries bellow before choosing the one that best fits your case, and proceed with the recommendations.

Issue
I am encountering a failure.
The library is not honoring an area of the CSS/HTML standard.
The library is not behaving as it claims or should.
I want to do X with this library, is it possible?
I am having trouble to understand how to use a specific feature of this library.

I am encountering a failure.

I am using react-native-render-html and I am witnessing a failure such as:

• A Red screen of death during development that is caused by an object of this library;

• A failure while building the app for production;

• A crash or exception when rendering a component of this library.

Recommendations

1. Read the FAQ.

2. Take a look at stackoverflow.com/questions/tagged/react-native-render-html for similar questions.

3. Take a look at our issue tracker for similar questions.

4. If you still don’t have a solution, you can choose one or more:

   1. Submitting a Bug Report.

   2. Going to our Discord #support channel.

The library is not honoring an area of the CSS/HTML standard.

For example, it doesn’t render tag YYY or replicate the behavior of attribute XXX. This library is not meant for an exact compliance with the standard. First and foremost, because React Native imposes some constraints that we cannot overcome, and secondly, because the philosophy of the library is to let you customize rendering to fit your needs rather than strictly honoring the standards. Finally, because the react-native-webview library fits this purpose.

However, we are always open to feature requests and propositions for enhancement regarding better compliance with the standards. You’re more than welcomed to open a ticket and discuss the feature on our #general Discord channel.

The library is not behaving as it claims or should.

For example:

1. The documentation says something, but the behavior differs.

2. The library should obviously have the behavior I’m expecting, but it doesn’t.

Recommendations

1. Make sure your HTML snippet is compliant with the HTML5 spec.

   1. Go to validator.w3.org/nu/.

   2. Select "Check by text input"

   3. Paste your snippet in the body of the document.

   4. Press "Check"

2. Make sure your issue isn’t covered by the docs.

3. Read the FAQ.

4. Take a look at stackoverflow.com/questions/tagged/react-native-render-html for similar questions.

5. Take a look at our issue tracker for similar questions.

6. If you still don’t have a solution, you can choose one or more:

   1. Submitting a Bug Report.

   2. Going to our Discord #support channel. Please note that if your issue is not trivial, we will probably ask you to fill a bug report anyway.

I want to do X with this library, is it possible?

Recommendations

1. Make sure the feature isn’t covered by the docs.

2. Read the FAQ.

3. Take a look at stackoverflow.com/questions/tagged/react-native-render-html for similar questions.

4. Take a look at our issue tracker for similar questions.

5. If you still don’t have an answer, you can choose one or more:

   1. Opening a StackOverflow post with the react-native-render-html tag.

   2. Submitting a Feature Request.

   3. Going to our Discord #support channel.

I am having trouble to understand how to use a specific feature of this library.

Recommendations

1. Carefully read the docs.

2. Read the FAQ.

3. If you still find difficult to use this feature, then we are lacking good documentation, and we should fix it. Go to our Discord #support channel and we will help you out.