Skip to content

Create Edge event reference & update API docs#306

Merged
timkimadobe merged 15 commits intoadobe:devfrom
timkimadobe:edge-event-reference
Feb 22, 2023
Merged

Create Edge event reference & update API docs#306
timkimadobe merged 15 commits intoadobe:devfrom
timkimadobe:edge-event-reference

Conversation

@timkimadobe
Copy link
Copy Markdown
Contributor

@timkimadobe timkimadobe commented Feb 17, 2023

Description

This PR creates the Edge event reference, mirrored from the Android version with the following updates:

  1. Types reflect Swift types
  2. Links updated to equivalent iOS versions

It also updates the API docs to align with the updated Android version:

  1. Updated wording using branding guidelines (acronym, extension name, etc.)
  2. Removed registerExtension API reference (since iOS does not have this API)
  3. Updated comment styling

See adobe/aepsdk-edge-android#44 for reference

Related Issue

Motivation and Context

How Has This Been Tested?

Screenshots (if appropriate):

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

  • I have signed the Adobe Open Source CLA.
  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes.
  • All new and existing tests passed.

Types should reflect swift types
links updated to equivalent ios versions
@timkimadobe timkimadobe changed the title Create Edge event reference docs Create Edge event reference doc Feb 17, 2023

| Key | Value type | Key Required | Description |
| --------- | ------------- | -------- | --------------------- |
| locationHint | `String` | Yes | Location hint value. Passing `null` or an empty string (`""`) clears the existing location hint. See the [list of valid location hints for the `EdgeNetwork` scope](https://experienceleague.adobe.com/docs/experience-platform/edge-network-server-api/location-hints.html). |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

...Passing nil ...


| Event type | Event source |
| --------------------------------- | ------------------------------------- |
| com.adobe.eventType.edge | This value is copied from the event being responded to; if not set or `null`, has a default value of com.adobe.eventSource.responseContent |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update this to just com.adobe.eventSource.responseContent as discussed previously for Android.


#### Data payload definition<!-- omit in toc -->

| Key | Value type | Key Required | Description |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Key Required -> Required everywhere

@codecov
Copy link
Copy Markdown

codecov bot commented Feb 17, 2023

Codecov Report

❗ No coverage uploaded for pull request base (dev@4e3a6b9). Click here to learn what that means.
The diff coverage is n/a.

@@          Coverage Diff           @@
##             dev     #306   +/-   ##
======================================
  Coverage       ?   95.35%           
======================================
  Files          ?       28           
  Lines          ?     1183           
  Branches       ?        0           
======================================
  Hits           ?     1128           
  Misses         ?       55           
  Partials       ?        0           

Fix null to nil
Update source to just responseContent like android

| API | Event type | Event source |
| ------------------------------- | -------------------------- | ------------------------------------ |
| [`Consent.update(with:)`] | com.adobe.eventType.edge | com.adobe.eventSource.updateConsent |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

url missing for API


-----

### Edge content response error
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Edge error response

@timkimadobe timkimadobe requested a review from addb February 22, 2023 02:30
@timkimadobe
Copy link
Copy Markdown
Contributor Author

@addb I did a text diff between this version and the android one; the only differences are:

  1. Data types
  2. Links to resources (for android or ios as appropriate)

Everything else should have the latest updates based on the feedback for the android version!

@timkimadobe timkimadobe linked an issue Feb 22, 2023 that may be closed by this pull request
Remove usage of AEP
Remove extra usage of Adobe Experience Platform
Update comment formatting
Update wording grammar to treat Edge Network as proper noun
Match wording and style from android version of doc
Use Edge Network name
@timkimadobe timkimadobe changed the title Create Edge event reference doc Create Edge event reference & update API docs Feb 22, 2023
@timkimadobe timkimadobe merged commit a59918b into adobe:dev Feb 22, 2023
@timkimadobe timkimadobe deleted the edge-event-reference branch February 22, 2023 23:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add event reference, clean up API reference

2 participants