Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Zeta docs update #2881

Closed
wants to merge 717 commits into from
Closed

Zeta docs update #2881

wants to merge 717 commits into from

Conversation

mwehr-zeta
Copy link
Contributor

Update Zeta docs

Copy link
Contributor

@bretg bretg left a comment

Choose a reason for hiding this comment

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

Zeta team - we need to talk about these parameters.

This documentation is publisher-facing. You should not be adding things like device.ip that are impossible or burdensome to publishers. Prebid Server sets these things when allowed by privacy regulations.

PBS and/or the Prebid SDK set many of these things, including a number of fields of site and app, tmax, buyeruid, and source.

The only items that should be in this documentation are the ones that publishers need to provide.

@MartianTribe
Copy link
Collaborator

@mwehr-zeta Have you addressed any of these issues?

@mwehr-zeta
Copy link
Contributor Author

I have not yet addressed the issues - will address soon.

leonardlabat and others added 25 commits June 8, 2021 13:37
Whenever bidders are added to the site they need to be assigned to a `list_group` from `dev-docs/bidders.md` via the individual bidder frontmatter. If a bidder isn’t assigned to a `list_group` then they won’t appear on the Bidders page.

This script checks all bidders and lists those that aren’t assigned to a `list_group`.

Exclude the script so it’s not included in the generated site.
* Added axonix.md

* Changed to single quotes
* iPROM bidder upload - docs

* Update iprom.md

added quotes around the string examples and made the link active

Co-authored-by: Gašper Žagar <gasper.zagar@iprom.si>
Co-authored-by: Jean Stemp <38964447+jeanstemp@users.noreply.github.com>
Restore expected CNAME for production site.

This reverts commit 0c0166c.
Allow indexing of production site.

This reverts commit 543ea07.
* breaking analytics adapters out into separate files

* new analytics adapter doc instructions

* new analytics adapter doc instructions

* giving specific guidance on the privacy policy flags
This is a better approach do it by parsing the title rather than relying on a value in the frontmatter
Make them sorted by title in a case-insensitive manner
* Create bcm.md

* Fixed the file location

* Revert "Fixed the file location"

This reverts commit 0849daf.

* Moved to dev-docs/bidders

Co-authored-by: Gabriela Melendez <gabriela@adkernel.com>
* Change params, add description

* Add support for gdpr, schain and video

* change param from ZoneId to zoneId
remove rows: top_nav_section , nav_section

* change param from ZoneId to zoneId
remove rows: top_nav_section , nav_section

* New adapter - videofy

* add updated supported, add example
* Native: add Custom Assets section

* wordsmithing

* Update native-implementation.md

Co-authored-by: bretg <bgorsline@gmail.com>
* Initial seutp of Laravel Mix for CSS/JS generation

* Inital webpack mix script

* Additional mix packages and build scripts

* Stub source files

* Adds bourbon and include-media for build

* Import sass from main site

* Initial import of required Bootstrap styling

Only bring in what we need to keep CSS size down

* Mark jQuery as an external

So that we can include it separately and still use it in webpack build pipeline

* Add Bootstrap and dependency

For styling and JS

* Ignore changes to build support files

* Setup support to automatically reload CSS when it changes

Via browsersync

Without this change I was having to wait for Jekyll to finish rebuilding the site in order to see CSS changes

* Initial setup for JS build

bootstrap import stubbed till we can figure out just which bits we need and can limit the import to keep JS size down

* Add new brand color token for dark colors

* Initial work styling header

* main CSS build entry point

* Initial build of CSS

* Initial work to update head for relaunch

Removing some unneeded CSS/JS dn prep work for new site fonts

* Review navigation markup to work with Bootstrap 4.x

* Regenerate production JS

* Copy JS with mix to support browsersync reloading

* Update nav to show proper main nav items

Use the same nav struct for mobile view as well

* Enable main nav JS functionality

* Load reset styles from Bootstrap

* Load the site in Chrome for development

* Load utility classes

Should see if we can trim this down at some point and not load _all_ of the utility classes

* Push nav to the right

* Reflow code for better readability

Also fix unbalanced tags and add comments to sort out unbalanced tag

* Reflow code for better readability

* Reload changes to HTML files

* Update width to match design comp

* Remove VC style helpers from WP

They’re not needed on this site

* Add another level of spacer

To keep with Bootstrap patterns but give us spacer to match the comp

* Implemented content and styling for homepage main content area.

* Update CNAME

* Can’t ignore CSS and JS files

The site won’t render correctly on GitHub Pages w/out them.

* Delete CNAME

* Create CNAME

* Delete trailing whitespace

* Close tags for better code

And so that browsersync integration works correclty

* Dev config file

So that we can ignore generated files w/out affecting the production process.

`bundle exec jekyll serve --config _config.yml,_config_development.yml`

* New token for divider color

* Initial work on interior page styling

* Reflow code to try to make indenting consistent

Added character names to conditionals/loops to keep them straight.

* In-progress work on left nav

Restructuring class handling to DRY up code and reduce complexity of if statements.
Tweaking classes to provide styling hooks.
Updates for showing active nav sections.

* Updating sidebar styling and markup to support comp

Still need to add carrot indicators

* Move content block to be child of column

To get more space between sidebar and content

* Don’t output cookie consent unless in production

To avoid the on-screen clutter during development

* Regenerate CSS

* Iterating on interior content styling

* Styling interior page bits

* Regenerate CSS

* Include bootstrap before bourbon

To let bourbon `size` mixin override the conflicting mixin from bootstrap

* Initial work on footer content and styling

* Cleanup nav styling

* Update logo to knockout version from comps

* Add carrots to sidebar elements

* Regenerate JS

* Tweak header to better match comp

* Iterating on dropdown styling

* Dropdown styling tweaks

To better match comp.
Added section classes to data for styling hooks.

* Regenerate CSS

* Enabled rollover styling for format tiles

Had to move svgs to be inline so we can change styling with CSS. Also changed the markup order so that we can change svgs on link hover.

* Card and hover treatment for source cards on medium banner

* Social media icons and styling

* Tweaks to “footer” on homepage

To better match comp.

* Regenerate CSS

* Don’t index content on review site.

* Tweaking font sizes and spacing

For better display of content on interior pages

* Get rid of wrapper element

Since it is preventing proper page width on some interior pages - content is spreading wider than the container

* Match table color in comp

* Properly mark nav items active that are simple nav items

* Get rid of &nbsp entities breaking sidebar layout

Any spacing/stying is being handled by CSS so no need for these layout bits in the sidebar config file.

* Rearrange content for better display in new design

* Add space below highlights

For better content display

* Tweak thead border width

To match comp

* Keep table looking decent if it overflows the container

* Include alert styles to match current site

* Regenerate CSS

* Better display of category groups in sidebar

* Prevent egregiously bad display with nested content blocks

* Breathing space above highlights

* Extract common head markup

Moving it to a single file makes it easy to share common asset include and setup details across all pages on the site.

This is a first setp to getting the `head` for video examples cleaned up.

* Update video examples to use common head include

To DRY up code

* Update video sample template

To use same design as other pages on the site.

* Style video example code like other code blocks

* Don’t add bullets to tab list items

* Expose standard BS alerts to brand-specific classes

squash

* Regenerate CSS

* Update template to get layout updates

To match new design.
Also remove trailing whitespace

* Reflow code for better readability

* Style common bidder tables

* Fix tags for proper footer display

Also, whitespace updates

* Delete trailing whitespace

* Update class for styling tweaks

* Update template structure for new design

Also, delete trailing whitespace

* Put margin below sidebar like pb-content

So that if sidebar is longer than content we still have the footer pushed down.

* Reflow code for better readability

* Fix missing closing tags

* 404 page layout and styling

* Regenerate CSS

* Fix button display on smaller screens

* Better display of social media on smaller screens

* Regenerate CSS

* Update README with changes for building assets

* Make Codes of Conduct and Policies into collapsible sections

* Add styling for custom table

By extending Bootstrap styles for ease of maintenance

* Make table responsive for example

Makes the table scrollable if it’s wider than the space.
Have to wrap the markdown in `div` tags and move the Inline Attribution List (https://kramdown.gettalong.org/syntax.html#inline-attribute-lists) to the bottom so that it doesn’t interfere with Markdown parsing of the table.
Also need to specify that the `div` contains markdown via `markdown=“1”` based on https://kramdown.gettalong.org/syntax.html#html-blocks

* Regenerate CSS

* Header padding on mobile

* Better mobile display of main nav

* Expose sidebar nav via toggle control on mobile

* Keep sidebar visible on larger screens

But collapse it behind the toggle on smaller screens.

* Move margin to footer

So that we don’t have extra margin below sidebar when left nav is collapsed on mobile

* Better spacing around sidebar on mobile

* Update other templates to show collapsed leftnav on mobile

* Update extra template to new design for completeness

* Regenerate CSS

* Use full bootstrap from CDN rather than limited local bootstrap

Since the local compiled bootstrap uses features of JS that aren’t supported in IE11 and aren’t being “fixed” by babel in testing.

* Tweak to fix hover behavior in IE11

* Regenerate CSS

* Adjust font sizes per feedback

Switching from sizes in design comp to Minor Thirds ratio to have more difference in font size between the levels.

* Add missing heading styling

h5 isn’t used in the content area on the site but adding it here so that it’s available in the future if an h5 is added.

* Make h4 italic per feedback

Required adding semi-bold italic font from Google for proper display in browsers.

* Revert italic for h4 after additional feedback

Leaving italic on h5 since h5 is same size as body copy and leaving italic-semi-bold include to support h5 styling.

* Regenerate CSS

* Tweaks to get more space for content

Make the overall page wider and the sidebar narrower, then give all that extra space to the content.

* Add padding to prevent nav text from running into icon

It didn’t in review/testing but this tweak will ensure it doesn’t in the future.

* Regenerate CSS

* Revert "Update CNAME"

Revert CNAME to be correct for production site before opening a PR.

This reverts commit 8c44d99.

* Remove no-index from headers

So that PR for production site doesn’t block search indexing.

* Delete old, unused references to JS build

Had to move away from JS build process due to issues generating a cross-browser JS file.

* Open marketing site link in new window

* Reduce top padding on code

Per request.

* Delete old, unused JS assets

* Better display of Download page

* Hide modal to match behavior on previous site design

* Merge styles for smaller CSS file

* Update bidders page to match main listing

* Better heading level for standalone page

* Make content area wider

For better display

* Link to standalone pages

So that the bidders page is an entryway, not a page with lots of content

* Delete old bidders content

Now being displayed on individual pages

* Placeholder for autocomplete

* Update CNAME for testing

* Don’t index staging site

* Setup new layout for individual API pages

Based on bidder layout

* Break apart main API page to sub-pages

For better UX and to get rid of long pages.

* Initial work to add search to site

* Don’t filter by tags for now

Testing site-wide search

* Initial basic autocomplete support

Link out to page on selection

* Classify bidders for grouping by name

* Text change per comp

* Setup bidder groupings

* Updated lockfile

* Add awesomplete package

So that we can pull in CSS without using CDN

* Add class for styling hook

* Remove CSS from CDN

We will be styilng via native site CSS

* Revise list output to prevent markdown from breaking generated markup

* Styling for bidder list and autocomplete

Per comp

* Reflow code

For more readable customizations

* Increase hits returned

Per feedback

* Only return 1 result per URL

* Hide facet groupings

Per feedback

* Regenerate CSS

* Simple cache busting

To get updated CSS to be used.

* Extract JS to external file

So that we can edit it w/out battling with Jekyll/Liquid parsing and formatting.

* Add support to sort results by name

For saner result display

* Revert "Break apart main API page to sub-pages"

This reverts commit a6b9e8e.

These updates are not ready to launch yet - revert them so they’re not part of the PR for bidder updates

* Revert "Setup new layout for individual API pages"

This reverts commit 23d00e5.

These updates are not ready to launch yet - revert them so they’re not part of the PR for bidder updates

* Add helper script to find ungrouped bidders

Whenever bidders are added to the site they need to be assigned to a `list_group` from `dev-docs/bidders.md` via the individual bidder frontmatter. If a bidder isn’t assigned to a `list_group` then they won’t appear on the Bidders page.

This script checks all bidders and lists those that aren’t assigned to a `list_group`.

Exclude the script so it’s not included in the generated site.

* Assign new bidders to list groups

* Revert "Update CNAME for testing"

Restore expected CNAME for production site.

This reverts commit 0c0166c.

* Revert "Don’t index staging site"

Allow indexing of production site.

This reverts commit 543ea07.

* Refactor grouping by name

This is a better approach do it by parsing the title rather than relying on a value in the frontmatter

* Better sort of bidder pages

Make them sorted by title in a case-insensitive manner

* Remove unneeded list_group

Now that we are grouping by parsing title, we no longer need the list_group in the frontmatter.

* Remove unneeded helper script

* Remove unneeded `list_group`

* Delete merge conflict tags

* Restore original line breaks
* as we are adding the prebid-server adaptor and introduced a few extra params , they are added here too
(note: those 3 new params would also reach the headerbid adserver in the case of prebid "clientside HB" too. So all good)

* added quotes around string params

Co-authored-by: bretg <bgorsline@gmail.com>
* describing opt-out

* fixing pubcommon opt out

* wordsmithing
bretg and others added 28 commits June 8, 2021 13:37
* fixed images stuck in blog directory

* fixed one that was missed

Co-authored-by: Jean Stemp <jstemp@appnexus.com>
* DMX:  Update params

Update server side  params to reflect supported params for DMX

* Update dmx.md

* wordsmithing

Co-authored-by: bretg <bgorsline@gmail.com>
* Added doc file for Grid Bid Adapter

* update doc for TheMediaGrid Bid Adapter

* Added video support in Grid doc file

* removing unnecessary front matter

* Update doc file for TheMediaGrid Bid Adapter

* Added doc file for TheMediaGridNM Bid Adapter

* Update doc file for TheMediaGrid Bid Adapter

* Update doc file for The Media Grid Bid Adapter

* Update THeMediaGrid doc to support TCF 2.0

* Update doc for TheMediaGrid Bid Adapter

* Update doc file for TheMediaGrid Bid Adapter

* Update doc for TheMediaGrid Bid Adapter

* Update TheMediaGrid doc to support coppa

* Update GridNM Bid Adapter doc file

Co-authored-by: bretg <bgorsline@gmail.com>
* docs update for eids object

* fixes by review

* other docs changes

* minor fix: all userIds

Co-authored-by: Surovenko Alexey <surovenko.alexey@gmail.com>
Co-authored-by: Love Sharma <love.sharma@indexexchange.com>
* Apacdex, Quantumdex, Valueimpression docs update

* edit dev-docs/bidders/apacdex.md
* added clarity on adUnit floors

* Prebid.js floors updates
…2992)

Co-authored-by: Wojciech Biały <wb@WojciechBialy.local>
#2975)

* Adnuntius Bidder documentation added

* Fixed targeting text.

* Added documentation for passing segments in the bidder config.

* changed the way to send user segments to bidder.

* Moved string to type + examples.
* Conversant adapter update doc to include mediaTypes.video as a source of video parameters

* Conversant adapter update doc to include mediaTypes.video as a source of video parameters - review changes
Co-authored-by: marc_tappx <marc@tappx.com>
* Update dev-docs with floc 

Adding documentation for the FLoC user id module.

* word smithing

* shortening example token

* adding full token back

Co-authored-by: bretg <bgorsline@gmail.com>
@mwehr-zeta mwehr-zeta closed this Jun 8, 2021
@mwehr-zeta mwehr-zeta deleted the zeta-docs-update branch June 8, 2021 18:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.