add doc and naming suggestions

lib/modules/datasource/bitrise/index.spec.ts

@@ -16,7 +16,7 @@ describe('modules/datasource/bitrise/index', () => {
       ).resolves.toBeNull();
     });
 
-    it('support GHE api url', async () => {
+    it('support GitHub Enterprise API URL', async () => {
       httpMock
         .scope(
           'https://github.mycompany.com/api/v3/repos/foo/bar/contents/steps',
@@ -60,7 +60,7 @@ describe('modules/datasource/bitrise/index', () => {
       });
     });
 
-    it('returns version and filter out asset folder', async () => {
+    it('returns version and filters out the asset folder', async () => {
       httpMock
         .scope(
           'https://api.github.com/repos/bitrise-io/bitrise-steplib/contents/steps',
@@ -156,7 +156,7 @@ describe('modules/datasource/bitrise/index', () => {
       ).resolves.toBeNull();
     });
 
-    it('returns null if there is an unexpected format a package', async () => {
+    it('returns null if the package has an unexpected format', async () => {
       httpMock
         .scope(
           'https://api.github.com/repos/bitrise-io/bitrise-steplib/contents/steps',

lib/modules/datasource/bitrise/readme.md

@@ -1,10 +1,14 @@
-This datasource allows to fetch Bitrise steps from Git repositories.
+Renovate uses this datasource to fetch Bitrise steps from GitHub repositories.
 
-**Currently only Github is support**
+| Renovate field | What value to use?                      |
+| -------------- | --------------------------------------- |
+| `packageName`  | Name of the Bitrise step                |
+| `registryUrl`  | GitHub HTTP Git URL, as used by Bitrise |
 
-As `packageName` the step name expected e.g. for the following snippet the `packageName` would be `script`.
+For example, in the YAML snippet below:
 
-`registryUrl` expects a GitHub HTTP Git Url as used below by Bitrise. See the `default_step_lib_source` field for an example.
+- `packageName` is `script`
+- `registryUrl` is `https://github.com/bitrise-io/bitrise-steplib.git`
 
 ```yaml
 format_version: 11